# General Translation Changelog: gt-sanity 4.0.0: 支持 Sanity 6.9.2+ Studio
URL: https://generaltranslation.com/zh/blog/gt-sanity_v4_0_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Fernando Aviles
Published: 2026-08-14

## 概述

`gt-sanity` v4 适用于 Sanity 6 Studio。Sanity 在 6.9.2 中将 `@sanity/ui` 从 3 升级至 4，而包含这一变更的 Studio 包属于运行时单例，因此该插件现在会从你的 Studio 中解析它们，而非打包自己的副本。

使用 Sanity 6.0 至 6.8 的 Studio 仍采用 `@sanity/ui` 3，应继续使用 `gt-sanity` 3.1.x。请先将 Sanity 升级至 6.9.2 或更高版本，再迁移到 v4。

v4 不会更改插件的 API 或你存储的 Content。如果你的 Studio 使用 Sanity 6.9.2 或更高版本，升级只需安装即可。

***

## 重大变更

### 需要 Sanity 6.9.2 和 `@sanity/ui` 4

`sanity` 的对等依赖版本范围现为 `^6.9.2`。此前为 `>=5.0.0`，因此即使插件的依赖项固定在 Sanity 5 系列，Sanity 6 也会被接受。安装时会正常解析而不发出警告，因此可能在没有任何明显提示的情况下出现重复的 Studio 运行时。

请注意，要求的是 Sanity 6.9.2，而非任意 Sanity 6。`@sanity/ui` 4 随 6.9.2 发布，因此使用 6.0 至 6.8 的 Studio 仍在使用 `@sanity/ui` 3 系列。请先升级 Sanity，再迁移到 `gt-sanity` 4。

### Studio 包现为对等依赖

`@sanity/ui`、`@sanity/icons`、`@sanity/schema` 和 `@sanity/mutator` 原为常规依赖项，现改为由宿主 Studio 解析的对等依赖。将它们与不同系列的 Sanity 一同安装会嵌套安装第二个副本，导致出现重复的 schema 注册表和 styled-components 主题上下文。Sanity 6.9.2+ Studio 已提供这四个包，因此无需额外安装。

`@sanity/document-internationalization` 和 `sanity-plugin-internationalized-array` 的最低版本分别提升至 `^6.2.30` 和 `^5.1.27`。之前的最低版本可能会解析到仅支持 Sanity 5 的版本，这也会导致运行时重复。已移除未使用的 `@sanity/util` 依赖项。

### 仅支持 ESM

与 `@sanity/ui` 4 保持一致，已移除 CommonJS 构建产物和 `require` 导出条件。请使用 ESM `import` 语法导入该插件。

### Node.js 22.12 或更高版本

从 18 升级至 22.12，与 `sanity` 和 `@sanity/ui` 4 保持一致。

***

## 继续使用 Sanity 5

`gt-sanity` 3.1.x 仍是适用于 Sanity 5 Studio 以及 Sanity 6.0 至 6.8 的受支持版本。它尚未弃用；如果你尚未准备好迁移 Studio，固定使用此版本也是合理的选择。

```bash
npm install gt-sanity@^3.1
```

v3 的功能集保持不变。将 Sanity 升级到 6.9.2 或更高版本后，迁移到 v4 无需更改代码或内容。

***

## 修复

此次升级还修复了几个问题：

* 当源区域设置被重新标记时 (例如从 `en` 改为 `en-US`) ，**发布翻译**会遗漏整个翻译组。此前，发布功能通过语言标签在 `translation.metadata` 中识别源条目，因此变更前写入的元数据文档无法匹配任何内容，导致该组被静默跳过。现在会根据条目引用的文档区分源条目和翻译条目。
* **全部翻译**和**全部导入**现在会显示进度。此前，在运行仍在进行时，两者看起来都处于空闲状态，因为它们只跟踪各自的请求，而不跟踪已入队的工作。
* **`gtStructureItems`**固定使用某个 Sanity API 版本，从而消除了 Sanity 表示将会升级为错误的弃用警告。

***

## 链接

* [快速入门](/docs/integrations/sanity/quickstart)
* [配置指南](/docs/integrations/sanity/guides/configuring-sanity)
* [API 参考](/docs/integrations/sanity/reference/plugin-configuration)

## Sitemap

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