如何免费高效翻译JSON/YAML文件？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项目，体验结构化数据翻译的高效解决方案！