Crowdin

面向开发者与开源社区的翻译管理平台（TMS），支持 700+ 集成、众包翻译与慷慨的 OSS 免费计划。

基本信息

技术定位与简介

Crowdin 是全球使用最广泛的本地化平台之一，特别适合软件字符串管理、开源社区翻译与开发者工作流集成。它支持 100+ 文件格式（JSON、YAML、XLIFF、Android XML、iOS strings、PO、properties 等），通过 GitHub/GitLab/Bitbucket 双向同步、CLI（crowdin）、API 与 700+ 应用市场集成，将翻译流程嵌入 CI/CD。

Crowdin 的差异化优势包括：对开源项目极其友好的免费额度、社区译者投票与 gamification（排行榜、徽章）、丰富的机器翻译提供商接入（OpenAI、DeepL、Google 等，按提供商原价计费）、以及 OTA（Over-The-Air）内容交付用于移动端热更新翻译。

快速上手安装说明

注册与创建项目

1. 访问 crowdin.com 注册账号
2. 创建 Project，选择源语言（如 English）
3. 添加目标语言（如 Chinese Simplified）

连接 Git 仓库

在 Project → Integrations 中连接 GitHub/GitLab，配置：

• 源文件路径（如 /locales/en.json）
• 翻译导出路径（如 /locales/%two_letters_code%.json）
• 同步分支与 PR 策略

CLI 安装与使用

npm install -g @crowdin/cli
 
# 初始化
crowdin init
 
# 上传源文件
crowdin upload sources
 
# 下载翻译
crowdin download

crowdin.yml 示例

project_id: '123456'
api_token_env: CROWDIN_PERSONAL_TOKEN
base_path: .
preserve_hierarchy: true
files:
  - source: /locales/en.json
    translation: /locales/%two_letters_code%.json

核心特性

• 版本控制集成：GitHub/GitLab 双向同步，翻译以 PR 形式回写。
• Crowdin CLI：上传/下载、分支管理、预翻译、状态检查。
• 机器翻译 + AI：多 MT 引擎、TM（翻译记忆）复用、AI 润色。
• 上下文预览：In-Context 本地化、截图关联、WYSIWYG 部分场景。
• 社区翻译：投票、评论、角色权限、译者排行。
• QA 检查：占位符一致性、长度限制、标签匹配。
• OTA 交付：移动端无需发版更新字符串（Enterprise/特定计划）。
• 安全合规：ISO 27001、GDPR、HIPAA（Enterprise）、SAML SSO。

适用场景

• 开源项目需要志愿者翻译与免费 TMS 额度。
• 前端/移动端通过 JSON、YAML、XLIFF 管理字符串。
• 需要 Git 驱动「翻译即 PR」的持续本地化流程。
• 游戏、社区产品需要众包翻译与质量投票。
• 多仓库、多分支、多环境（staging/production）本地化。

技术亮点

• 集成数量行业领先：700+ 应用与连接器，覆盖 Figma、Jira、Slack、Contentful 等。
• OSS 友好：符合条件的开源项目可免费使用核心能力。
• MT 提供商透明计价：相较部分竞品，不统一加价 MT 用量（以官方定价为准）。
• 开发者文档完善：CLI、API v2、Webhooks、GitHub Actions 示例丰富。

核心概念与架构

开发者仓库（源 locale 文件）
      ↓
 Crowdin Git 集成 / CLI upload
      ↓
 Crowdin 项目（源字符串 + TM + 术语表）
      ↓
 人工翻译 / MT / 社区译者
      ↓
 QA + 审批工作流
      ↓
 download / PR 回写 / OTA API
      ↓
 应用运行时加载最新翻译

核心概念

• Source strings：以源语言为基准的字符串单元。
• Translation Memory (TM)：历史译文复用，降低成本。
• Glossary：术语表，保证品牌词一致。
• Workflow：自定义翻译→校对→审批状态机（Enterprise）。

技术局限与边界

• UI 相对传统：部分用户认为界面不如 Lokalise 现代。
• 按席位计费：项目经理席位成本随团队扩大上升。
• 复杂工作流需高阶计划：多供应商、高级 workflow 在 Enterprise。
• 非运行时 i18n 框架：需与 i18next、next-intl、vue-i18n 等配合，本身不替代代码层库。
• 国内访问：偶发网络延迟，需评估团队地理位置与镜像策略。

生态地图

• 平台：Crowdin Cloud、Crowdin Enterprise
• CLI：@crowdin/cli
• API：REST API v2、Webhooks
• GitHub Action：crowdin/github-action
• IDE：部分编辑器插件、In-Context JS snippet
• 对比竞品：Lokalise、Phrase、Transifex、Tolgee、Weblate

生态集成

• 前端：JSON/YAML 同步至 locales/、messages/ 目录。
• i18next / vue-i18n：标准 JSON 结构直接对接。
• Next.js：CI 中 crowdin download 后构建。
• React Native / Flutter：OTA 或资源文件同步。
• Figma：部分设计稿文案同步（需插件或集成）。

开发与工程化

• crowdin.yml 入库：与代码同版本管理，避免本地配置漂移。
• CI 门禁：PR 前检查源文件 upload 成功、目标语言 100% 或阈值。
• 分支策略：feature 分支翻译与 crowdin branch 对应。
• 占位符规范：统一 {name} 或 ICU 语法，启用 QA 规则。
• Secrets：CROWDIN_PERSONAL_TOKEN 存于 CI secrets，禁止提交仓库。

性能与安全

• 性能：翻译加载在应用侧；Crowdin 侧主要影响 CI 上传下载耗时。
• 安全：Enterprise 提供 SSO、审计日志；API token 最小权限原则。
• 合规：处理用户可见文案时注意 PII 不要进入可公开翻译项目。

技术对比

最佳实践

1. 开源项目先申请 OSS 计划，再配置 Git 集成。
2. 源语言单一真相：只在一个路径维护源 JSON，避免双写。
3. 启用 QA 检查：占位符、HTML 标签、长度限制。
4. 术语表先行：产品名、按钮动词统一后再大规模翻译。
5. CI 自动化 download：构建前拉最新翻译，避免生产落后 TMS。
6. 区分 MT 与人工：关键营销文案人工审校，次要 UI 可用 MT 预翻。

学习与社区资源

• 文档：https://support.crowdin.com
• Developer Portal：https://developer.crowdin.com
• CLI：https://github.com/crowdin/crowdin-cli
• GitHub Action：https://github.com/crowdin/github-action
• 社区：Crowdin Community、论坛、开源项目案例