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

title: useRegion
description: 使用 General Translation gt-react 读取当前区域。useRegion 的 API 参考。

---

`useRegion` 钩子会从 [`<GTProvider>`](/docs/react/reference/components/gt-provider) 上下文中返回用户当前选定的区域；如果未设置，则返回 `undefined`。

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

*注意：`gt-tanstack-start` 不导出此钩子。*

## 概览 [#overview]

调用 `useRegion` 以读取当前启用的区域代码。

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

export default function RegionDisplay() {
  const region = useRegion(); // [!code highlight]
  return <p>Current region: {region ?? 'Not set'}</p>;
}
```

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

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

区域通过 [`<RegionSelector>`](/docs/react/reference/components/region-selector) 组件或 [`useRegionSelector`](/docs/react/reference/hooks/use-region-selector) 钩子来设置。如果用户尚未选择区域，该钩子会返回 `undefined`。

## 返回值 [#returns]

**类型** `string | undefined`

当前生效的 区域 代码，例如 `US` 或 `CA`；如果未设置 区域，则为 `undefined`。

## 注意事项 [#notes]

* 在异步 App Router 组件中，请改用 [`getRegion`](/docs/react/nextjs/reference/functions/get-region)。
* 要更改区域，请使用 [`useSetRegion`](/docs/react/reference/hooks/use-set-region) 或 [`<RegionSelector>`](/docs/react/reference/components/region-selector)。