# General Translation React SDKs (gt-react, gt-next): useDefaultLocale
URL: https://generaltranslation.com/zh/docs/react/reference/hooks/use-default-locale.mdx
---

title: useDefaultLocale
description: 使用 General Translation gt-react 读取源（默认）区域设置。useDefaultLocale 的 API 参考。

---

`useDefaultLocale` 钩子会从 [`<GTProvider>`](/docs/react/reference/components/gt-provider) 上下文中返回应用的默认 (源) 区域设置。这是后备语言，会在用户首选的区域设置不可用时使用。

*可在 `gt-react`、`gt-next`、`gt-tanstack-start` 和 `gt-react-native` 中使用。示例从 `gt-react` 导入；请改为从你所用框架对应的包中导入。*

## 概览 [#overview]

调用 `useDefaultLocale` 获取源区域设置。

```tsx
import { useDefaultLocale } from 'gt-react';

export default function DefaultLocale() {
  const defaultLocale = useDefaultLocale(); // [!code highlight]
  return <p>Default locale: {defaultLocale}</p>;
}
```

*注意：在 `gt-react` 中，请在 [`<GTProvider>`](/docs/react/reference/components/gt-provider) 内调用 `useDefaultLocale`。在 `gt-next` 中，它也可以在服务器组件中调用。*

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

默认区域设置通过配置中的 [`defaultLocale`](/docs/react/reference/config#default-locale) 进行设置；如果未指定，则默认为 `en`。

## 返回值 [#returns]

**类型** `string`

应用程序的默认区域设置，例如 `en-US`。

## 注意事项 [#notes]

* `useDefaultLocale` 是同步的，可在服务器组件和客户端组件中使用。
* 要读取用户当前生效的区域设置，请使用 [`useLocale`](/docs/react/reference/hooks/use-locale)。