# General Translation React SDKs (gt-react, gt-next): resolveCanonicalLocale
URL: https://generaltranslation.com/zh/docs/react/nextjs/reference/functions/resolve-canonical-locale.mdx
---

title: resolveCanonicalLocale
description: 在 Next.js App Router 的服务器端代码中，使用 General Translation 解析已配置的区域设置别名。resolveCanonicalLocale 的 API 参考。

---

`resolveCanonicalLocale` 函数会将区域设置或已配置的别名解析为其规范的 BCP 47 区域设置代码。在 App Router 的服务器端代码中从 `gt-next/server` 导入该函数。

`resolveCanonicalLocale` 仅可在服务器端使用，不适用于 Pages Router。

## 概览 [#overview]

```tsx
import { resolveCanonicalLocale } from 'gt-next/server';

const locale = resolveCanonicalLocale('brand-french'); // 'fr-FR'
```

## 参数 [#parameters]

| 参数       | 描述             | 类型       | 可选 | 默认值 |
| -------- | -------------- | -------- | -- | --- |
| `locale` | 要解析的区域设置代码或别名。 | `string` | 否  | —   |

## 返回值 [#returns]

**类型** `string`

为该值配置的规范区域设置。自定义别名来自 [`customMapping`](/docs/react/reference/config#custom-mapping) 配置。

## 示例 [#example]

```tsx
import { resolveCanonicalLocale } from 'gt-next/server';

resolveCanonicalLocale('en-us'); // 'en-US'
```