# gt-next: General Translation Next.js SDK: useDefaultLocale
URL: https://generaltranslation.com/zh/docs/next/api/helpers/use-default-locale.mdx
---
title: useDefaultLocale
description: useDefaultLocale Hook 的 API 参考
---

{/* 自动生成：请勿直接编辑。请改为编辑 content/docs-templates/ 中的模板。 */}


## 概述

`useDefaultLocale` Hook 会从 [`<GTProvider>` 上下文](/docs/next/api/components/gtprovider)中获取应用的默认区域设置。
该区域设置表示应用的后备语言，通常在用户首选区域设置不可用时使用。

<Callout>
  `useDefaultLocale` 是一个客户端 Hook，*只能在客户端组件中使用*。
  请确保你的应用已包裹在 [`<GTProvider>`](/docs/next/api/components/gtprovider) 中。
</Callout>

配置方式请参阅 [`gt.config.json`](/docs/next/api/config/gt-config-json)。
如果未指定默认区域设置，则默认值为 `'en-US'`。

## 参考

### 返回值

一个表示应用默认区域设置的字符串，例如 `'en-US'`。

***

## 示例

### 基本用法

获取应用的默认区域设置，并在组件中显示出来。

```jsx title="DefaultLocale.jsx" copy
'use client';
import { useDefaultLocale } from 'gt-next';

export default function DefaultLocale() {
  const defaultLocale = useDefaultLocale(); // [!code highlight]

  return <p>Default locale: {defaultLocale}</p>; // 显示默认区域设置
}
```

***


## 注意事项

* `useDefaultLocale` hook 依赖 [`<GTProvider>`](/docs/next/api/components/gtprovider) 提供的上下文。
  请确保你的应用已在根级使用 provider 包裹。
* `useDefaultLocale` 仅支持客户端。
* 在[这里](/docs/core/locales)了解有关区域设置字符串的更多信息。

## 后续步骤

* 请参阅 [`useLocale`](/docs/next/api/helpers/use-locale) 以获取用户的区域设置。