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

title: getTranslations
description: 使用 General Translation 在异步 Next.js App Router 组件中读取词典中的翻译。getTranslations 的 API 参考。

---

`getTranslations` 函数会为当前 App Router 请求返回一个异步的词典查找函数。当异步组件无法使用 [`useTranslations`](/docs/react/reference/hooks/use-translations) 时，请从 `gt-next/server` 导入该函数。

`getTranslations` 仅可用于服务器端，不适用于 Pages Router。

## 概览 [#overview]

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

const t = await getTranslations();
const heading = t('home.heading');
```

## 参数 [#parameters]

| 参数       | 描述                 | 类型       | 可选 | 默认值 |
| -------- | ------------------ | -------- | -- | --- |
| `rootId` | 加到每个词典 `id` 前面的前缀。 | `string` | 是  | —   |

## 返回值 [#returns]

**类型** `Promise<(id: string, options?: DictionaryTranslationOptions) => string>`

解析后得到的函数会返回给定 id 对应的已翻译词典条目，并接受 [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options) 参数。它还提供用于访问嵌套词典对象的 `.obj(id)`。

## 示例 [#example]

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

export default async function AccountPage() {
  const t = await getTranslations('account');
  return <h1>{t('heading')}</h1>;
}
```