知识库

使用 General Translation 对应用、文档和内容进行本地化的常见问题解答。

国际化

在代码库中配置 i18n：库、框架和组件。

如何翻译 Flask 或 FastAPI 应用？标记面向用户的字符串，为每个请求确定区域设置（通常依据 Accept-Language），然后加载该区域设置的译文。Flask 应用通常使用 Flask-Babel 搭配 gettext 消息目录，FastAPI 应用则通过中间件接入 Babel。General Translation 的 CLI 可以填充这些消息目录，而其实验性的 gt-flask 和 gt-fastapi SDK 无需消息目录，即可翻译内联的 t() 字符串。视频52秒
如何使用 strings.xml 本地化 Android 应用？将所有默认字符串放在 res/values/strings.xml 中，在带区域设置限定符的文件夹（如 values-es 或 values-b+zh+Hant+TW）下为每种语言各添加一个 strings.xml，并通过 stringResource 或 getString 读取文本。翻译可以手动完成，也可以在 Play Console 中完成，或者使用 General Translation 的 CLI——它会生成每个 values 文件夹，并为每种目标语言重建复数形式。视频49秒
如何为 TanStack Start 添加 i18n？TanStack Start 没有内置 i18n，因此你需要引入一个库，在每个服务端请求中解析区域设置（通常依据 URL 前缀或 cookie），并在渲染前加载消息。Paraglide JS、react-i18next 和 Lingui 负责渲染你提供的译文；General Translation 的实验性库 gt-tanstack-start 还能根据 JSX 中内联编写的文案自动生成译文。视频48秒
如何为 Next.js Pages Router 应用添加 i18n？在 next.config.js 中添加包含 locales 和 defaultLocale 的 i18n 配置块后，Next.js 便会提供 /es 和 /fr 等路径，根据浏览器语言重定向访问者，并将区域设置传递给 getStaticProps 和 getServerSideProps。消息由库负责渲染；General Translation 的 gt-next 还能根据直接以内联方式写在 JSX 中的文案生成译文。视频55秒
如何翻译 Vue 应用？翻译 Vue 应用，就是让每个模板字符串都按当前语言进行查找，并将其翻译成每种目标语言。General Translation 的 gt-vue 插件会翻译包裹在 <T> 组件中的内容，npx gt translate 则会为每种目标语言生成一个目录。视频48秒
如何翻译 React 应用？翻译 React 应用，需要先对组件进行国际化，使其以用户的语言渲染，再将每个字符串翻译成你支持的各种语言。General Translation 的 gt-react 在 <T> 组件中原地翻译 JSX，npx gt translate 则会为每种语言生成一个文件。视频48秒
如何翻译 React Native 应用？在组件中标记文本，为每种语言生成一个翻译文件，添加 Intl 兼容性补丁，然后根据设备语言加载对应的文件。使用 General Translation 实验性的 gt-react-native 时，只需用 <T> 包裹文本，Babel 插件会自动添加 polyfills，npx gt translate 则负责生成翻译文件。视频47秒
如何翻译 Node.js 应用？检测每个请求的语言（通常依据其 Accept-Language 请求头），并以该语言返回所有字符串。General Translation 的 gt-node 通过 withGT 为每个请求绑定区域设置，并通过 getGT 翻译字符串，所用译文由 npx gt translate --publish 在部署前生成。视频48秒
如何翻译 JSX 之外的字符串？对于每个不属于 JSX 子节点的字符串（例如占位符或模块作用域常量），应在其渲染的位置通过翻译函数处理。General Translation 的 useGT 钩子会返回该函数，而 msg 搭配 useMessages 可以翻译在组件外部定义的常量。视频49秒
如何使用 Cursor 或 Claude Code 为应用实现国际化？在 Cursor 或 Claude Code 中使用 General Translation 的 Setup for Agents 提示词，选定一个功能和目标语言，然后让智能体完成实现并验证结果。借助浏览器登录、机器可读文档和 MCP 工具，初始化设置可以与翻译和审校环节无缝衔接。使用 Locadex，即可通过拉取请求自动完成后续的持续本地化工作。视频46秒
如何为 Next.js App Router 应用添加 i18n？首先在受支持的 App Router 项目中运行 gt init 来配置 General Translation，然后标记源内容、生成译文并验证语言切换。gt-next 将文案与翻译上下文一同保留在 JSX 中；CLI、仪表板编辑器和 Locadex 负责生成、审校和持续更新。本指南还演示了如何显式配置本地文件。视频51秒
语言切换器最佳实践：用户体验、SEO 与无障碍访问用每种语言的本语名称来标注它，例如 Deutsch 或日本語，不要使用国旗，因为国旗代表的是国家。每个选项都应通过可抓取的链接指向该语言版本的同一页面，用 cookie 记住用户的选择，并且切勿对已本地化的 URL 自动重定向。视频47秒
应该如何命名 i18n 翻译键？应按文本出现的位置及其含义来命名键，例如 checkout.summary.title，而不是照搬英文措辞。即使英文相同，不同用途也应各用一个键：德语会把按钮上的 Open 译为 Öffnen，而把状态 Open 译为 Offen。视频46秒
如何让网站支持多语言？先确定译文放在哪里：代理、CMS 插件、建站工具，还是你自己的代码；然后按照 Google 的建议，为每种语言分配独立的 URL。完整翻译页面以及标题和元描述，用 hreflang 关联各语言版本，并提供语言切换器，而不是自动重定向访问者。视频50秒
如何检测用户的浏览器语言？读取浏览器提供的有序语言列表（在 JavaScript 中为 navigator.languages，在服务器端为 Accept-Language 标头），按 q 值排序，再与你支持的语言区域进行匹配，并设置后备语言区域。Safari 和 Chrome 无痕模式只会报告一种语言，而 IP 地理定位只能反映用户所在位置，无法反映其使用的语言。视频47秒
如何找出未翻译的硬编码字符串？在 CI 中运行 linter，标记面向用户的字符串字面量，例如 JSX 可使用 eslint-plugin-i18next 的 no-literal-string 规则，Android 可使用 Android Lint 的 HardcodedText 检查，Rails 可使用 erb_lint 的 HardCodedString linter。然后切换到伪区域设置，逐一浏览应用，找出静态检查无法追踪到的文本。视频48秒
如何使用 String Catalogs 本地化 iOS 应用？在 Xcode 中添加语言，使用 SwiftUI Text 和 String(localized:) 等可本地化 API 编写面向用户的文本，然后执行构建，Xcode 会将这些字符串收集到 String Catalog（.xcstrings）中。翻译可以在 Xcode 中完成，也可以借助 XLIFF；如果希望目录随版本发布同步更新，并与你的网站和 Android 应用共享术语，可以使用 General Translation 的 CLI。视频44秒
国际化与本地化（i18n 与 l10n）国际化（i18n）是让一款产品支持多种区域设置的代码与设计工作，例如使用 Intl 格式化日期、支持从右到左的文本等。本地化（l10n）则针对某一区域设置对产品进行适配，除翻译外，还涵盖货币、日期格式、计量单位、语气和法律细节等方面。视频52秒
什么是伪本地化？伪本地化是一种测试方法：将源文本替换为改写后的版本——加上重音符号、长度扩充约 40%，并用方括号包裹——这样在还没有任何翻译之前，硬编码字符串、截断、字体显示异常和句子拼接等问题就会暴露出来。Android 为此内置了 en-XA 和 ar-XB 两个伪区域设置。视频48秒
应该自建 i18n，还是使用 General Translation？手写的 i18n（每种语言一个字典，外加一个简单的 t() 辅助函数）足以应对一两种语言、少量文案的场景。随着应用规模扩大，你会发现自己在重新实现复数规则、后备内容和文件同步，而且译文仍然得自己产出。General Translation 的开源库负责渲染，General Translation 则根据你的代码生成并更新译文。视频43秒
多语言应用本地化测试清单在生产环境构建中，于每个支持的区域设置下测试九项内容：包括错误状态和邮件在内的完整流程、语言切换、复数形式、货币与时区、文本扩展、从右到左布局、无障碍访问、译文交付，以及可抓取的语言 URL。为每项检查设定明确的通过标准。视频33秒
react-intl 替代方案：General Translation 与 react-intl 对比General Translation 让 React 团队在保留 ICU 消息语法的同时，获得译文生成、共享术语和仪表板审校能力。react-intl 提供格式化功能和 FormatJS 目录工具；General Translation 还能直接生成译文。视频47秒
i18next 替代方案：General Translation 与 i18next 对比如果你希望将文案内联在 React 组件中，并借助其 JSX 结构和产品上下文生成译文，请选择 General Translation。你也可以继续使用 i18next，并用 General Translation 翻译现有的目录。i18next 负责消息渲染和复数形式选择，译文则需要由单独的服务生成。视频47秒
General Translation 与 vue-i18n 对比：该选哪一个？General Translation 让 Vue 团队可以直接在模板中编写源文案，并通过 CLI 生成译文。其 gt-vue 插件在渲染这些内容时，会应用符合区域设置的复数形式和数字格式化。如果你希望免去维护基于键的源文件，可以选择它；而对于使用 Nuxt i18n 模块、已有成熟目录工作流的团队，vue-i18n 依然是合适的选择。视频42秒
General Translation 与 Symfony Translation：该选哪一个？Symfony Translation 负责在 PHP 和 Twig 中渲染消息。General Translation 则在 CI 中翻译其 YAML 消息目录，随源内容的变化持续同步更新，并为审校人员提供可直接编辑译文的仪表板。保留 Symfony 的渲染机制，同时为你的发布工作流加入自动化翻译。视频44秒
General Translation 与 Rails I18n：两者都需要吗？Rails I18n 负责查找消息并格式化日期和数字。General Translation 负责生成译文，在英文内容变更时让译文保持同步，并为团队提供用于审校的仪表板。两者搭配使用，即可在每次发布时交付已翻译的 Rails 目录。视频44秒
General Translation 与 Paraglide JS：该选哪一个？如果你希望将文案内联在代码中，并结合 React 组件结构、共享术语和仪表板审阅来生成译文，请选择 General Translation。如果你需要编译生成的带类型消息函数，以及按单条消息进行的 tree-shaking，请选择 Paraglide JS。Paraglide 负责渲染你的消息目录；General Translation 则将源文案与译文生成及后续更新衔接起来。视频42秒
General Translation 与 nestjs-i18n：该选哪一个？nestjs-i18n 在 NestJS 应用中为每个请求解析语言，并从按语言划分的 JSON 或 YAML 消息目录中渲染消息，但它本身并不翻译任何内容。General Translation 的 CLI 可以翻译这些消息目录，其 gt-node 库则能翻译仅在运行时才存在的内容。因此，你可以继续使用 nestjs-i18n，同时引入 General Translation。视频45秒
General Translation 与 Mobility：该选哪一个？Mobility 将翻译后的模型属性存储在您的数据库中。General Translation 则通过其 API，结合您的词汇表和自定义提示词生成这些译文。两者搭配使用，即可在保留现有 Rails 模型的同时，翻译商品列表、文章及其他数据库内容。视频44秒
General Translation 与 Lingui：该选哪一个？如果你希望像使用 Lingui 一样将文案内联在代码中，同时以 JSX 结构作为上下文自动生成译文，请选择 General Translation。Lingui 会将内联消息提取到消息目录中，交由译者或已连接的服务翻译。General Translation 的 CLI 会随代码变更自动更新译文，你的团队可以在仪表板中审阅。视频45秒
General Translation 与 Intlayer：该选哪一个？Intlayer 将每个组件的内容保存在组件旁的类型化声明文件中，所有语言并排编写，并可借助你配置的 AI 提供商补全缺失的语言。General Translation 则将文案以单一语言内联在组件中，并结合代码上下文生成其他语言的译文。视频42秒
General Translation 与 i18next、react-intl 和 next-intl 对比：应该选择哪个国际化库？i18next、react-intl 和 next-intl 等开源库本身并不翻译任何内容。它们只负责显示你在各语言目录文件中提供的译文，这些译文由你、你的译者或其他服务编写。General Translation 的库同样开源，承担同样的工作，此外 General Translation 还会以你的代码为上下文完成翻译。视频43秒
General Translation 与 GNU gettext：两者都需要吗？继续用 GNU gettext 负责提取和渲染，再引入 General Translation 来生成和维护 PO 文件。General Translation 会把译者备注和消息上下文纳入生成过程，统一应用共享术语，并为审校人员提供仪表板编辑器。你现有的 gettext 调用和已编译的消息目录均保持原样。视频46秒
General Translation 与 Django 翻译框架：两者都需要吗？将 Django 的翻译框架与 General Translation 搭配使用。Django 负责消息提取、语言选择和渲染；General Translation 则基于你的产品术语和仪表板审阅，填充 Django 的 PO 文件（包括复数形式）。你的模板和 URL 模式无需改动，译文会随代码同步更新。视频46秒
General Translation 与 Babel、Flask-Babel 对比：该选哪一个？Babel 可以为任意区域设置格式化日期、数字和货币，并管理 gettext 消息目录；Flask-Babel 则负责将其集成到 Flask 中，但两者都不会翻译你的字符串。General Translation 的 CLI 会为每种语言填充 Babel 的 PO 文件（包括复数形式），因此你可以继续使用 Flask-Babel，不必再手动翻译消息目录。视频46秒
不使用翻译文件能实现 i18n 吗？可以。借助 General Translation 的 gt-react 和 gt-next 库，你可以为 React 和 Next.js 实现 i18n，既无需翻译键，也不用为每种语言维护 JSON 文件。文案以内联方式写在 JSX 的 <T> 组件中，gt translate 命令会在构建时结合代码中的上下文，为每种语言生成译文。Locadex 还能通过拉取请求让译文保持最新。视频46秒
如何翻译 JSX 中的条件文本？保持句子完整，并翻译它的每个版本。三元表达式会把句子拆成碎片，使其失去含义，也无法适应各语言的语序。General Translation 通过在 <T> 中使用 <Branch> 解决这一问题，将整个句子作为一个整体进行翻译。视频46秒

按区域设置格式化

各区域设置下的复数形式、日期、数字、货币和从右到左的文本。

翻译

机器翻译与 AI 翻译、翻译质量、上下文和词汇表。

多语言 SEO

多语言网站的区域设置路由、hreflang、站点地图和已翻译的元数据。

工作流工具

选择本地化工具，并通过持续本地化保持译文同步。

立即部署

加入 General Translation，与全球顶尖开发者团队同行

开始使用预约演示