Crowdin 完整使用攻略：用 AI 为开源项目做本地化
是什么 / 适合谁
Crowdin 是一款面向软件本地化的 AI 翻译协作平台，由爱沙尼亚团队 Crowdin 出品。它的核心价值在于：让开发者、翻译者和 AI 翻译引擎在同一套系统里协同工作，把软件界面、文档、网站等内容的翻译流程自动化。
它不同于普通的翻译工具（如 DeepL 或 Google 翻译），Crowdin 更关注“项目级”的翻译管理——支持版本控制、上下文预览、翻译记忆、术语库等功能，并且内置了 AI 翻译引擎（如 OpenAI、Google AutoML 等）来加速翻译过程。
适合谁：
- 开源项目维护者：需要社区贡献翻译，但不想手动合并 PR
- 企业产品团队：管理多语言版本，希望减少重复劳动
- 本地化项目经理：协调多名译员，追踪翻译进度
- 个人开发者：为自己的小项目做国际化，想省时省力
不适合谁：
- 只需要一次性翻译少量文本的用户（直接用 ChatGPT 或 DeepL 即可）
- 完全不懂代码、也不打算学习项目管理流程的纯翻译人员
- 对数据隐私要求极高、无法接受云端存储的团队
阶段学习路径
第 1 天：快速上手，完成第一个翻译项目
目标：创建一个项目，导入源文件，用 AI 翻译完成第一版，并导出结果。
- 注册账号：访问 Crowdin 官网，用 GitHub / GitLab 账号或邮箱注册。注意：国内访问可能需要稳定的网络环境，建议使用常规宽带，不要使用任何代理工具。
- 创建项目：点击“New Project”，输入名称（如“MyApp-i18n”），选择源语言（如简体中文）和目标语言（如英语、日语、法语）。建议先选 2-3 种语言测试。
- 上传源文件：支持 JSON、YAML、PO、XLIFF、Markdown 等格式。以最常见的 JSON 为例，上传
en.json 文件（假设源语言是英语）。
- 启用 AI 翻译：进入项目设置 → “Machine Translation”，选择“OpenAI”或“Google AutoML”。首次使用需要配置 API 密钥（需自行在 OpenAI 官网申请，注意：国内申请 OpenAI API 需合规途径，请自行了解当地法规）。
- 自动翻译：回到项目首页，点击“Pre-translate via Machine Translation”，选择目标语言，系统会自动调用 AI 引擎完成初翻。
- 手动校对：进入翻译编辑器，可以看到 AI 翻译的结果。点击字符串，可以手动修改。编辑器右侧会显示上下文截图（如果上传了截图），帮助理解原文含义。
- 导出翻译：项目完成后，点击“Build”，选择目标语言，系统会生成翻译后的文件。可以下载到本地，或直接配置自动同步到 GitHub。
第一天成果：你完成了一个 100 条字符串的翻译项目，AI 翻译准确率约 70-80%，手动调整后达到 95% 以上。
第 1 周：掌握协作与自动化
目标：配置团队协作、Git 集成、翻译记忆库，让项目持续运转。
- 邀请协作者：在项目设置中点击“Members”，输入成员的邮箱或用户名。可以分配角色：Manager（管理项目）、Translator（翻译）、Proofreader（校对）。
- 配置 Git 集成：在项目设置 → “Integrations” → “GitHub”，授权 Crowdin 访问你的仓库。配置后，每次代码更新（如修改了
en.json），Crowdin 会自动拉取最新源文件，触发 AI 翻译，并将翻译结果提交回仓库。注意：Git 集成需要仓库有写权限，建议使用专用机器用户账号。
- 建立术语库：在项目设置 → “Glossary”中，添加关键术语的翻译。例如，你的产品名“SmartNote”在日语中应保持为“SmartNote”，而不是被翻译成“スマートノート”。术语库会优先于 AI 翻译。
- 启用翻译记忆库：翻译记忆库（TM）会记录已翻译的字符串，当遇到相同或相似文本时，自动复用。在项目设置中开启“Translation Memory”，建议使用“Crowdin TM”或自建 TM 服务器。
- 设置质量检查：在“QA”选项卡中，开启一致性检查（如“术语不一致”、“数字占位符缺失”等），避免低级错误。
第一周成果：你的项目实现了“代码更新 → 自动拉取 → AI 翻译 → 人工校对 → 自动提交”的闭环，团队可以并行翻译不同语言。
进阶：深度定制与扩展
目标：利用 API 和 Webhook 实现自定义工作流，处理复杂本地化需求。
- 使用 REST API：Crowdin 提供完整的 API，可以用 Python 或 Node.js 脚本批量操作。例如：自动上传截图、更新翻译状态、拉取翻译进度报告。API 文档在官方开发者页面。
- 配置 Webhook：在项目设置中设置 Webhook，当翻译完成或文件更新时，自动触发你的 CI/CD 流程。例如：翻译完成后自动构建多语言版本并部署到测试环境。
- 自定义 AI 模型：如果你有大量历史翻译数据，可以训练自己的 AI 翻译模型。Crowdin 支持上传 TMX 文件作为训练数据，然后使用“Custom Machine Translation”引擎。
- 处理占位符与变量：对于软件本地化，字符串中常包含
{name}、%s 等占位符。在 Crowdin 编辑器中，这些占位符会被高亮显示，防止翻译者误修改。进阶用户可以在源文件中添加注释，说明占位符的含义。
- 多文件版本管理：当项目有多个分支（如
dev、release）时，可以在 Crowdin 中创建对应分支，分别管理翻译。避免分支合并时翻译冲突。
优势
- AI 翻译效率极高：内置多个 AI 引擎，支持一键预翻译，大幅缩短人工翻译时间。对于常见的技术文档，AI 翻译准确率可达 80% 以上。
- 开发者友好：原生支持 Git、GitHub、GitLab 集成，翻译文件与代码仓库双向同步，无需手动导入导出。
- 社区翻译模式：开源项目可以免费使用 Crowdin 的社区计划，允许外部贡献者提交翻译，维护者只需审核。
- 上下文预览：支持上传截图并关联到翻译字符串，译员可以看到文本在界面中的实际位置，避免脱离语境的误译。
- 翻译记忆与术语库：复用已有翻译，保持术语一致性，尤其适合长期维护的多语言项目。
短板
- 国内访问不稳定：Crowdin 服务器在海外，国内用户访问时可能出现加载缓慢或偶尔断开的情况。建议使用常规宽带，避免使用任何网络加速工具。
- 学习曲线：对于非技术用户，理解“源文件格式”、“翻译记忆”、“分支管理”等概念需要时间。如果只是偶尔翻译少量文本，不建议使用。
- AI 翻译依赖外部 API：使用 OpenAI 等引擎需要自行申请 API 密钥，且调用会产生费用（按 token 计费）。
- 免费版限制：免费版最多支持 1 个项目，且翻译存储空间有限（约 10 万字符串）。对于大型项目，需要付费。
价格规划
Crowdin 提供免费版和付费版：
- 免费版：1 个项目，最多 10 万字符串，支持社区翻译和 AI 翻译（需自备 API 密钥）。
- 付费版：按项目数量、字符串数、用户数阶梯定价。例如：
- 团队版（约 $50/月）：2 个项目，50 万字符串，5 个用户
- 企业版（约 $200/月）：无限项目，无限字符串，无限用户，优先支持
- 开源项目：可以申请“Open Source Plan”，完全免费（需项目在 GitHub 上公开，且通过审核）。
建议：个人开发者或小型团队，先用免费版测试 1-2 周，确认流程符合需求后再升级。开源项目直接申请免费计划。
不合适怎么办
如果 Crowdin 不适合你（例如：国内访问太慢、不需要项目管理、只想快速翻译），可以考虑以下替代方案：
- 单次翻译：使用 DeepL 网页版或 ChatGPT，直接粘贴文本翻译，适合零散需求。
- 轻量级本地化：使用 Lokalise 或 Transifex，它们有更简洁的界面，但同样需要海外访问。
- 纯开源方案：使用 Weblate（自建服务器），完全开源，可部署在国内服务器上，但需要一定运维能力。
- AI 翻译 API 直接调用：如果你只需要翻译 JSON 文件，可以用 Python 调用 OpenAI API，写个脚本批量处理，省去平台费用。
最后建议：Crowdin 的核心优势在于“项目管理 + 协作 + 自动化”。如果你的项目需要多人长期维护多语言版本，且团队能接受海外平台的网络条件，它是最佳选择之一。否则，请根据实际需求选择更轻量的工具。
