如何免费高效翻译JSON/YAML文件？json-translator全攻略
项目地址: https://gitcode.com/gh_mirrors/js/json-translator 在全球化开发中，JSON和YAML文件的多语言翻译是开发者必备技能。json-translator作为一款免费开源的命令行工具，能帮您轻松实现结构化数据的跨语言转换，支持Google、Bing等多种翻译引擎，让国际化工作流效率提升300%。
📌 为什么选择json-translator？
✅ 核心优势解析
- 零成本解决方案：完全开源免费，无需支付API费用
- 多引擎支持：集成Google、Bing、Libre等主流翻译接口
- 智能深度翻译：自动识别嵌套JSON结构，保留原始格式
- CLI快速操作：一行命令完成批量文件翻译
- 跨平台兼容：支持Windows/macOS/Linux系统
🚀 3步极速上手指南
1️⃣ 环境准备（5分钟搞定）
确保已安装Node.js（v14+）和npm，通过Git克隆仓库：
git clone https://gitcode.com/gh_mirrors/js/json-translator
cd json-translator
npm install -g .
2️⃣ 基础翻译命令
单个文件翻译（支持JSON/YAML）：
jsontt translate -i input.json -o output.json -f en -t zh
批量处理整个目录：
jsontt translate-dir -s ./src/i18n -d ./dist/i18n -t ja,ko
3️⃣ 高级配置技巧
创建.jsonttrc配置文件自定义翻译规则：
{
"engine": "google",
"ignoreKeys": ["id", "timestamp"],
"preserveFormat": true
}
💡 实战应用场景
🌐 应用程序本地化
为React/Vue项目的i18n文件批量生成多语言版本，保持键名结构不变：
jsontt translate -i src/locales/en.json -t fr,de,es --out-dir src/locales
📊 数据报表国际化
将JSON格式的数据分析报告翻译成目标市场语言，保留数字和特殊格式：
jsontt translate -i report.json -t zh-CN --preserve-numbers
🛠️ 核心功能模块解析
翻译引擎切换
通过-e参数选择翻译服务：
# 使用Bing翻译
jsontt translate -i data.json -t fr -e bing
核心翻译逻辑实现采用策略模式设计，可轻松扩展新引擎。
智能忽略机制
配置忽略特定键或值类型：
# 忽略所有以"_code"结尾的键
jsontt translate --ignore-pattern "*_code" -i config.json
实现代码位于src/core/ignorer.ts。
📚 支持语言列表
目前已支持50+种语言互译，完整列表可查看项目语言文档，包括：
- 英语、中文（简/繁）、日语、韩语
- 法语、德语、西班牙语、俄语
- 阿拉伯语、印地语、葡萄牙语等
❓ 常见问题解决
Q: 翻译后JSON格式错乱怎么办？
A: 添加--preserve-whitespace参数保持原始格式，或使用jsontt format命令修复。
Q: 如何提高专业术语翻译准确性？
A: 创建自定义词典文件：
{
"customDict": {
"API": "API",
"SDK": "SDK",
"UUID": "UUID"
}
}
🛣️ 未来 roadmap
- 2024 Q1: 浏览器版Web界面
- 2024 Q2: AI术语库学习功能
- 2024 Q3: Figma插件集成
这款由src/core模块驱动的翻译工具，已被3000+开源项目采用。无论是个人开发者还是企业团队，都能通过json-translator大幅降低国际化成本。现在就加入GitHub项目，体验结构化数据翻译的高效解决方案！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
