国际化：协同翻译 Crowdin & 机翻 API 推荐（DeepL vs OpenAI）
为什么组件库需要国际化
国际化并不仅仅是安装一个 i18n 插件那么简单。对于开源项目来说，国际化是推广的关键因素之一。在国际上推广较好的插件和模块库，发展态势往往更好。
国际化的适用范围分为两个层面：
| 场景 | 适用方案 | 说明 |
|---|---|---|
| 组件级文字 | vue-i18n | 按钮、标签、提示等少量、固定的文字内容 |
| 文档站/大篇幅内容 | 独立站点 + 协同翻译平台 | 每种语言对应独立的文档站，不适合用 $t() 替换 |
I18N 名称由来
I18N 是 Internationalization（国际化）的缩写 -- 从首字母 I 到末尾字母 N 之间恰好有 18 个字符。它既是国际化的简称，也是 Vue 生态中最常用的国际化插件名称。
大型文档站的国际化方案
像 VueUse、Wagtail JS 这类大型开源项目，每种语言都会维护一个独立的文档站。以 VueUse 为例：
- 在 GitHub 仓库的
src目录下有translations文件夹 - 每种语言对应一个独立的仓库（如
wagtail-translations组织） - 法语、韩语等各有独立维护分支
优势：编写文档时使用原生 Markdown，无需在语法中嵌入 $t() 函数。
劣势：语言切换时跳转到不同站点，而非同一页面内切换。
协同翻译平台推荐
Crowdin（推荐）
Crowdin 是 Element Plus 官方使用的协同翻译平台，提供：
- 可视化翻译界面：左侧原文、中间翻译区、右侧评论/历史
- 进度追踪：黄色表示未翻译、红色表示缺失、绿色表示已完成
- 多格式支持：JSON、Markdown、YAML、Vue SFC 等
- 团队协作：支持评论、审核、角色权限管理
- AI 集成：内置 AI 预翻译能力
官网：https://crowdin.com
开源项目可申请免费计划
text
其他平台
| 平台 | 特点 |
|---|---|
| Transifex | 老牌翻译平台，支持 60+ 文件格式，API 完善 |
| Phrase | 集成设计工具（Figma 等），适合产品团队 |
| GitLocalize | 轻量级，直接与 GitHub 仓库集成 |
机器翻译 API 对比
2026 年主流翻译 API 价格与特点
| API | 免费额度 | 付费价格 | 翻译质量 | 国内可用性 |
|---|---|---|---|---|
| DeepL API Free | 50 万字符/月 | Pro: 5.49/月起+25/百万字符 | 最佳（接近人工） | 需代理 |
| OpenAI GPT-4o-mini | -- | 0.15/百万输入token,0.6/百万输出 token | 优秀，可定制风格 | 需代理/国内镜像 |
| 百度翻译 API | 5 万字符/月（标准） | 49 元/百万字符 | 良好 | 直接可用 |
| 有道翻译 API | 1000 字/天 | 48 元/百万字符 | 良好，支持术语库 | 直接可用 |
| 腾讯翻译君 | 500 万字符/月 | 50 元/百万字符 | 良好 | 直接可用 |
DeepL API 定价详解
Free 计划：
- 50 万字符/月
- 适合中小型文档初次翻译
- 后续小更新基本够用
Pro 计划：
- $5.49/月（基础）
- $25/百万字符
- 支持文档级翻译、术语表
text
OpenAI 翻译成本计算
以翻译 50 万字中文内容为英文为例：
输入（Input）：
50 万字 / 500 字 ≈ 1000 次 token 调用
1000 x $0.011 ≈ ¥11（约）
输出（Output）：
50 万字翻译约 55 万 token
550 x $0.015 ≈ ¥8.25（约）
总成本 ≈ ¥19 ~ ¥25（含 prompt 开销）
text
对比结论
| 维度 | DeepL | OpenAI | 百度/腾讯 |
|---|---|---|---|
| 翻译质量 | 最高 | 高，可定制 | 良好 |
| 成本（50万字） | ~¥76（Pro） | ~¥25 | ~¥25-50 |
| 中文优化 | 优秀 | 优秀 | 良好 |
| 国内直接使用 | 不可 | 不可 | 可以 |
| 术语控制 | 支持术语表 | 通过 prompt 控制 | 有道支持术语库 |
方案选择建议
组件库级国际化
使用 vue-i18n + Element Plus 内置国际化，适合少量固定文案的切换。
文档站级国际化
方案一：Git 仓库协同
├── 每种语言一个独立仓库或分支
└── 适合有固定翻译团队的项目
方案二：翻译平台协同（如 Crowdin）
├── 集成 GitHub/GitLab
├── 可视化翻译界面
├── 内置 AI 预翻译
└── 适合社区驱动的开源项目
方案三：机器翻译 API 自动化
├── CI/CD 集成翻译 API
├── 初次翻译后人工校验
└── 适合快速迭代的项目
text
推荐组合策略
1. 组件文字 → vue-i18n（下节课实操）
2. 文档内容 → Crowdin 协同 + DeepL/OpenAI 预翻译
3. 日志/动态内容 → 翻译 API 实时调用
text
总结
- 国际化不仅仅是 i18n 插件，需要根据场景选择合适方案
- 组件级用 vue-i18n，文档级用协同翻译平台
- DeepL 翻译质量最高但成本较高，OpenAI 性价比更好
- 国内可直接使用百度/腾讯翻译 API，免代理烦恼
- Crowdin 是 Element Plus 等开源项目首选的协同翻译平台
↑