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

title: getGT
description: 在异步 Next.js App Router 组件中使用 General Translation 翻译独立字符串。getGT 的 API 参考。

---

`getGT` 函数会为当前 App Router 请求返回一个异步的字符串翻译函数。当异步组件无法使用 [`useGT`](/docs/react/reference/hooks/use-gt) 时，请从 `gt-next/server` 导入它。

`getGT` 仅限服务器端使用，不适用于 Pages Router。

## 概览 [#overview]

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

const gt = await getGT();
const label = gt('Submit');
```

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

* **构建时翻译。** 生产环境翻译会在部署前准备好，并根据当前请求的区域设置进行加载。
* **开发翻译。** 开发 API 密钥可让你在开发过程中启用按需翻译。
* **静态源字符串。** 请传入字符串字面量，以便编译器提取它们。
* **变量。** 插值内容会在翻译完成后再插入，不会被翻译。

## 返回值 [#returns]

**类型** `Promise<(content: string, options?: GTTranslationOptions) => string>`

Promise 解析后得到的函数会翻译源字符串，并接受插值变量以及 [`GTTranslationOptions`](/docs/react/reference/types/inline-translation-options)，例如 `$context`、`$id` 和 `$maxChars`。

## 示例 [#example]

```tsx title="app/contact/page.tsx"
import { getGT } from 'gt-next/server';

export default async function ContactPage() {
  const gt = await getGT();
  return <input aria-label={gt('Email address')} />;
}
```