# General Translation React SDKs (gt-react, gt-next, gt-react-native): TanStack Start
URL: https://generaltranslation.com/zh/docs/react/tanstack-start.mdx
---

title: TanStack Start
description: 了解适用于 General Translation 的 TanStack Start 专属设置、区域设置路由和同构运行时 API。

---

`gt-tanstack-start` 可将 General Translation 集成到 TanStack Start 应用中。它重新导出共享的 `gt-react` 组件、钩子和函数，新增了同构运行时辅助函数，并通过其主入口提供请求中间件。

如果你刚开始使用，请先阅读 [TanStack Start Quickstart](/docs/react/tanstack-start-quickstart)。共享的 [Guides](/docs/react/guides/configuring) 和 [参考](/docs/react/reference/config) 涵盖了所有跨框架通用的内容；本页只介绍 TanStack Start 专属的设置。

<Callout type="warn">
  **警告：** `gt-tanstack-start` 仍处于实验阶段，可能会有破坏性变更。目前尚不建议在生产环境中使用。
</Callout>

## TanStack Start 的专属内容是什么 [#overview]

* **请求中间件。** 从 `gt-tanstack-start` 注册 [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware)，为服务器函数创建请求局部状态。
* **Router 和 root 路由设置。** 在 `src/router.tsx` 的模块作用域中调用 [`initializeGT`](/docs/react/reference/config#initialize)，使用 [`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale) 解析区域设置，在 root 路由加载器中加载翻译快照，并将两者传给 [`<GTProvider>`](/docs/react/reference/components/gt-provider)。参见[设置](/docs/react/tanstack-start/setup)。
* **区域设置路由。** 使用可选的 `/{-$locale}` 路由段或 URL 重写，将 TanStack Router 配置为同时接受无前缀和带区域设置前缀的 URL。然后将 `localeRouting` 设为 `true`，以便在路径名中保留非默认区域设置，同时让默认区域设置不带前缀。参见[设置](/docs/react/tanstack-start/setup#locale-routing)。
* **同构运行时函数。** 使用 [`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale)、[`getEnableI18n`](/docs/react/tanstack-start/reference/functions/get-enable-i18n)、[`getGT`](/docs/react/tanstack-start/reference/functions/get-gt)、[`getMessages`](/docs/react/tanstack-start/reference/functions/get-messages) 和 [`getTranslations`](/docs/react/tanstack-start/reference/functions/get-translations) 读取运行时状态并执行翻译。在服务器端，请在 [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) 的请求作用域内调用它们。

## 页面 [#pages]

| 页面                                                                 | 描述                                                |
| ------------------------------------------------------------------ | ------------------------------------------------- |
| [设置](/docs/react/tanstack-start/setup)                             | 注册请求中间件，初始化 General Translation，并为 provider 注入数据。 |
| [使用服务器函数](/docs/react/tanstack-start/using-server-functions)       | 在 TanStack Start 服务器函数中翻译字符串并读取请求状态。              |
| [参考](/docs/react/tanstack-start/reference/functions/gt-middleware) | 浏览 `gt-tanstack-start` Runtime API。               |