# General Translation Platform: isSameLanguage
URL: https://generaltranslation.com/zh/docs/platform/core/reference/utility-functions/locales/is-same-language.mdx
---

title: isSameLanguage
description: 在没有 GT 实例的情况下，检查两个区域设置是否具有相同的基础语言。isSameLanguage 的 API 参考。

---

[`isSameLanguage`](/docs/platform/core/reference/gt-class-methods/locales/is-same-language) 是 General Translation 核心库中的一个独立实用函数，用于检查多个 BCP-47 区域设置代码是否表示同一种基础语言，并忽略区域差异。

## 概览 [#overview]

直接从 `generaltranslation` 导入 `isSameLanguage`，并传入两个或更多区域设置代码进行调用。它不需要 API Key，也不需要 [GT](/docs/platform/core/reference/gt-class/constructor) 实例。若要使用基于实例的对应写法，请改用 [`GT`](/docs/platform/core/reference/gt-class/constructor) 实例上的 [`isSameLanguage`](/docs/platform/core/reference/gt-class-methods/locales/is-same-language) 方法。

```typescript
import { isSameLanguage } from 'generaltranslation';

console.log(isSameLanguage('en-US', 'en-GB')); // true
console.log(isSameLanguage('en-US', 'es-ES')); // false
```

签名：

```typescript
isSameLanguage(...locales: (string | string[])[]): boolean
```

## 工作原理 [#how-it-works]

* **基础语言比较。** 仅比较基础语言代码 (第一个连字符前的部分) ，忽略区域、书写系统和变体差异。
* **可变参数输入。** 接受数量不定的参数，每个参数都可以是区域设置字符串或区域设置字符串数组。

## 参数 [#parameters]

| 参数                    | 描述                | 类型                       | 可选 | 默认值 |
| --------------------- | ----------------- | ------------------------ | -- | --- |
| [`locales`](#locales) | 用于比较的两个或以上区域设置代码。 | `(string \| string[])[]` | 否  | —   |

### `locales` [#locales]

**类型** `(string | string[])[]` · **必填**

用于比较的区域设置代码的其余参数。每个参数都可以是一个区域设置字符串，或一个区域设置字符串数组。

## 返回值 [#returns]

**类型** `boolean`

如果所有区域设置代码都表示同一种基础语言，则为 `true`；否则为 `false`。

## 示例 [#examples]

```typescript
import { isSameLanguage } from 'generaltranslation';

// 相同语言，不同地区
console.log(isSameLanguage('en-US', 'en-GB')); // true
console.log(isSameLanguage('es-ES', 'es-MX')); // true
console.log(isSameLanguage('zh-CN', 'zh-TW')); // true

// 不同语言
console.log(isSameLanguage('en-US', 'es-ES')); // false
console.log(isSameLanguage('fr-FR', 'de-DE')); // false
```

## 注意事项 [#notes]

* 仅比较基础语言代码 (即第一个连字符前的部分) 。
* 忽略区域、书写系统和变体差异。
* 对按语言组织内容至关重要。
* 支持可变数量的参数。