# General Translation Changelog: gt-react 10.8.0: 支持功能开关的 i18n
URL: https://generaltranslation.com/zh/blog/gt-react_v10_8_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2025-11-14

## 概述

在 **gt-react 10.8.0** 中，我们新增了通过 `enableI18n` 字段控制的功能开关支持。这样你就可以按需禁用国际化，并且同时支持同步和异步加载模式。

***

## 同步行为

当 `enableI18n` 设为 `false` 时，i18n 功能会按以下方式被禁用：

* 将区域设置列表限制为仅默认区域设置
* 将用户的区域设置设为默认区域设置

```tsx
<GTProvider enableI18n={false}>
  {/* i18n 已禁用 - 仅默认区域设置可用 */}
</GTProvider>
```

***


## 异步行为

对于动态功能开关，使用 `enableI18nLoaded` 指示加载状态：

```tsx
<GTProvider 
  enableI18n={featureFlag} 
  enableI18nLoaded={isLoaded}
>
  {/* 内容 */}
</GTProvider>
```

当 `enableI18nLoaded` 不为 `undefined` 时：

* `false`：功能开关正在加载中 (使用默认的 `enableI18n` 值) 
* `true`：功能开关已加载完成

在加载过程中，库会检查 `generaltranslation.enable-i18n` cookie 来确定当前状态。加载完成后，会优先采用显式指定的 `enableI18n` 值。

***


## SSG/SSR 注意事项

对于 SSG，由于静态生成无法判断运行时功能开关的状态，因此当 `enableI18n` 的默认值为 `false` 时，首次渲染会被跳过。

SSR 目前的行为也类似，不过我们计划在后续版本中为 Next.js Pages Router 提供正式的 SSR 支持。对于 Next.js App Router，请改用 `gt-next`。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.