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

title: TanStack Start
description: 了解适用于 General Translation 的 TanStack Start 专属设置，包括 root 路由初始化、区域设置解析以及 provider hydration。

---

`gt-tanstack-start` 可将 General Translation 集成到 TanStack Start 应用中。它重新导出共享的 `gt-react` 组件、钩子和函数，并新增了一个 `parseLocale` 辅助函数，用于在服务器端和浏览器中解析请求的区域设置。唯一需要处理的框架专属部分，就是接好 root 路由。

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

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

## TanStack Start 的特定内容是什么 [#overview]

* **root 路由设置。** 你需要在模块级别调用 [`initializeGT`](/docs/node/reference/functions/initialize-gt)，使用 `parseLocale` 解析区域设置，在路由加载器中加载翻译快照，并将两者传给 [`<GTProvider>`](/docs/react/reference/components/gt-provider)。参见[设置](/docs/react/tanstack-start/setup)。
* **`parseLocale`。** 这是一个辅助函数：在服务器端，它会从请求 Cookie 和 `Accept-Language` header 中读取区域设置；在浏览器中，则从 Cookie 读取。这是 `gt-tanstack-start` 唯一特有的导出；其余内容都来自 `gt-react`。

## 页面 [#pages]

| 页面                                     | 描述                                                  |
| -------------------------------------- | --------------------------------------------------- |
| [设置](/docs/react/tanstack-start/setup) | 初始化 General Translation，并在 root 路由中为 provider 注入数据。 |