# sanity: 常见问题
URL: https://generaltranslation.com/zh/docs/sanity/faqs.mdx
---
title: 常见问题
description: GT Sanity 插件常见问题
---

### 我需要修改 schema 吗？

不需要。`gt-sanity` 插件可直接兼容您现有的 Sanity schema。您无需为文档类型添加 i18n 字段，也不必重构数据模型。翻译内容会以独立文档的形式存储，并由插件为您创建和管理。

### 我需要更新我的 GROQ 查询吗？

需要。该插件会创建带有 `language` 字段的独立翻译文档，但不会修改前端查询。你需要更新 GROQ 查询，以便根据每位用户的区域设置获取相应的语言版本。示例请参阅[快速入门](/docs/sanity/guides/quickstart#querying-translated-content)。

### 该插件支持哪些版本的 Sanity？

`gt-sanity` 插件 v2 要求使用 Sanity Studio v5 或更高版本 (以及 React 19+) 。如果你使用的是 Sanity v3 或 v4，请使用 `gt-sanity` v1。

### 我可以翻译单个文档，还是只能翻译整个站点？

两者都可以。你既可以逐个翻译单个文档，也可以使用批量操作一次翻译多个文档或整个站点。你还可以按区域设置有选择地导入翻译。

### 插件如何处理 Portable Text？

文档会被序列化为 HTML 后再进行翻译，同时保留其结构和元数据。Portable Text、嵌套对象、数组以及自定义 schema 类型都支持。你也可以提供[自定义序列化器](/docs/sanity/guides/serialization)，以控制特定字段类型的处理方式。

### 我可以将该插件添加到已上线且已有内容的现有项目中吗？

可以。该插件专为现有 Sanity 项目设计，无需任何迁移或重构。它会读取您现有的文档，并将翻译内容作为独立文档的副本创建出来。您的源内容和 schema 都不会被改动。

### 翻译会覆盖我现有的内容吗？

不会。译文会存储在独立翻译文档中，而不会写入您的源文档。您的源文档绝不会被修改。您可以独立查看、编辑和管理这些译文。