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

title: isSameDialect
description: 在不依赖 GT 实例的情况下，检查两个区域设置是否表示同一种方言。isSameDialect 的 API 参考。

---

[`isSameDialect`](/docs/platform/core/reference/gt-class-methods/locales/is-same-dialect) 是 General Translation 核心库提供的一个独立实用函数，用于检查多个 BCP-47 区域设置代码是否表示同一种方言。

## 概览 [#overview]

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

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

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

签名：

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

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

* **方言比较。** 将基础语言视为其各区域变体的父级，因此基础语言可匹配任一对应的区域方言；区域变体则必须完全一致。
* **可变参数输入。** 接受数量不定的参数，每个参数都可以是区域设置字符串或区域设置字符串数组。

## 参数 [#parameters]

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

### `locales` [#locales]

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

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

## 返回值 [#returns]

**类型** `boolean`

如果所有区域设置代码表示的是同一种方言，则返回 `true`；否则返回 `false`。

## 示例 [#examples]

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

console.log(isSameDialect('en-US', 'en-US')); // true
console.log(isSameDialect('en', 'en-US')); // true（基础语言与区域变体匹配）
console.log(isSameDialect('en-US', 'en-GB')); // false（区域不同）
console.log(isSameDialect('en-US', 'es-ES')); // false（语言不同）
```

## 注意事项 [#notes]

* 将基础语言视为区域变体的父级。
* 区域变体必须精确匹配。
* 这对区域设置回退逻辑至关重要。
* 支持灵活的输入格式。
* 无需外部依赖。