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

title: isSameLanguage
description: 检查两个区域设置代码是否具有相同的基础语言。isSameLanguage 的 API 参考。

---

检查多个 BCP-47 区域设置代码在忽略区域 和 书写系统 差异时，是否表示同一种基础语言；该检查在 [GT](/docs/platform/core/reference/gt-class/constructor) 实例上执行。General Translation 使用它来判断语言兼容性，并按语系对内容进行分组。

## 概览 [#overview]

在 [`GT`](/docs/platform/core/reference/gt-class/constructor) 实例上调用 `isSameLanguage`，并传入两个或更多区域设置代码 (或代码数组) 。如果它们的基础语言都相同，则返回 `true`。

```typescript
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'es-ES' });

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

签名：

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

*注意：`isSameLanguage` 在本地运行，无需 API 密钥。若要在没有 `GT` 实例的情况下进行比较，请参阅独立的 [`isSameLanguage`](/docs/platform/core/reference/utility-functions/locales/is-same-language)。*

## 工作方式 [#how-it-works]

* **基础语言比较。** 仅比较基础语言代码 (第一个连字符前的部分) 。
* **忽略子标签。** 会忽略区域、书写系统和变体差异。
* **可变参数输入。** 支持数量可变的区域设置参数，可接受字符串、数组或混合形式。

## 参数 [#parameters]

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

### `...locales` [#locales]

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

用于比较的一个或多个区域设置代码 (string) 或区域设置代码数组。提供的所有区域设置都必须属于同一种基础语言。

## 返回值 [#returns]

**类型** `boolean`

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

## 示例 [#examples]

```typescript
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'es-ES' });

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

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

// 基础语言与变体
console.log(gt.isSameLanguage('en', 'en-US', 'en-GB')); // true
```

## 注意事项 [#notes]

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