json-autotranslate项目中数组翻译问题的解决方案

json-autotranslate项目中数组翻译问题的解决方案

【免费下载链接】json-autotranslate Translate a folder of JSON files containing translations into multiple languages. 项目地址: https://gitcode.com/gh_mirrors/js/json-autotranslate

在i18n国际化开发过程中，json-autotranslate是一个实用的自动化翻译工具，它能够帮助开发者快速完成多语言资源的转换。然而，近期有用户反馈在使用该工具处理包含数组结构的JSON文件时遇到了问题。

问题背景

当源语言JSON文件中包含数组结构时，例如：

{
  "instructions": ["do a thing", "do another thing"]
}

使用json-autotranslate工具进行翻译时，会抛出"input.match is not a function"的错误。这是因为工具内部的i18next匹配器在处理数组类型时没有进行适当的类型检查。

问题分析

该问题的根源在于匹配器代码直接对输入值调用了match方法，而没有先判断输入是否为字符串类型。当输入是数组时，JavaScript会抛出类型错误，因为数组对象没有match方法。

解决方案演进

项目维护者迅速响应，分两个阶段解决了这个问题：

1. 初始解决方案：增加了--with-arrays命令行参数，允许工具处理数组结构。但此版本存在一个缺陷，它会将数组转换为以索引为键的对象形式，不符合i18next对数组结构的支持标准。

2. 最终解决方案：在后续提交中修复了数组转换问题，确保输出保持原始数组结构。现在工具能够正确处理如下转换：

// 输入
{
  "arrayActual": [
    "do something",
    "do something else"
  ]
}

// 输出
{
  "arrayActual": [
    "做事",
    "干别的"
  ]
}

使用建议

对于需要使用json-autotranslate处理包含数组的i18n资源的开发者，建议：

1. 确保使用1.22.4或更高版本
2. 当源JSON中包含数组时，添加--with-arrays参数
3. 验证输出是否保持了预期的数组结构

技术启示

这个案例提醒我们，在开发国际化工具时需要考虑各种数据结构可能性。特别是对于i18n这种可能包含复杂嵌套结构的场景，工具应该：

1. 进行充分的输入类型检查
2. 保持数据结构的一致性
3. 提供清晰的错误提示和文档说明

json-autotranslate的快速迭代展示了开源社区响应问题的效率，也为其他国际化工具的开发提供了有价值的参考。

【免费下载链接】json-autotranslate Translate a folder of JSON files containing translations into multiple languages. 项目地址: https://gitcode.com/gh_mirrors/js/json-autotranslate