i18n-auto-translation项目中的DeepL翻译API分隔符问题解析

i18n-auto-translation项目中的DeepL翻译API分隔符问题解析

i18n-auto-translation Auto translate i18n JSON file(s) to desired language(s). 项目地址: https://gitcode.com/gh_mirrors/i1/i18n-auto-translation

问题背景

在使用i18n-auto-translation工具进行JSON文件翻译时，开发者遇到了一个奇怪的翻译结果问题。当从法语(FR)翻译到意大利语(IT)时，生成的翻译文件中出现了意外的换行符(\n)，并且部分键值对被合并到了一个翻译结果中。

问题现象

原始法语JSON文件结构清晰：

{
  "Admin": {
    "Sidebar": {
      "actions": "Actions",
      "api_usages": "Utilisations API",
      "disconnect": "Se déconnecter",
      "establishments": "Établissements",
      "playground": "Expérimentations",
      "users": "Utilisateurs"
    }
  }
}

但生成的意大利语翻译结果却出现了异常：

{
  "Admin": {
    "Sidebar": {
      "actions": "Azioni",
      "api_usages": "API utilizza",
      "disconnect": "Disconnettersi\n\nStabilimenti\n\nEsperimenti",
      "establishments": "Utenti"
    }
  }
}

问题分析

经过技术分析，这个问题源于DeepL翻译API对句子分隔符的处理方式。i18n-auto-translation工具在默认配置中使用特定的句子分隔符将多个待翻译文本合并为一个请求发送给API，以提高翻译效率。

然而，DeepL API在处理这些分隔符时出现了意外行为：

1. 部分分隔符被转换为换行符(\n)
2. 部分翻译结果被错误地合并
3. 导致最终解析时键值对对应关系错乱

解决方案

项目维护者最终确认了两种可行的解决方案：

方案一：修改句子分隔符

在translate.ts文件中修改默认的句子分隔符(Translate.sentenceDelimiter)，使用DeepL API能够更好处理的特殊分隔符。这个方案在v1.5.0版本中已经实现，用户只需更新到最新版本即可解决问题。

方案二：逐条翻译处理

对于急需解决方案的用户，可以采用逐条翻译的方式，即每次API调用只处理一个翻译项。虽然这种方法会降低翻译速度，但能确保翻译结果的准确性。实现方式是对valuesForTranslation数组进行遍历，为每个值单独发起API请求。

技术建议

1. 对于使用DeepL API的用户，建议直接升级到v1.5.0或更高版本
2. 如果遇到类似问题，可以尝试调整句子分隔符的配置
3. 在关键业务场景下，可以考虑实现翻译结果验证机制
4. 对于大型翻译项目，建议先进行小批量测试，确认无误后再进行完整翻译

总结

i18n-auto-translation工具与DeepL API的集成问题展示了在自动化翻译过程中可能遇到的技术挑战。通过理解API的特性和工具的工作原理，开发者能够更好地解决类似问题，确保国际化工作的顺利进行。项目维护者的快速响应和解决方案也体现了开源社区的高效协作精神。

i18n-auto-translation Auto translate i18n JSON file(s) to desired language(s). 项目地址: https://gitcode.com/gh_mirrors/i1/i18n-auto-translation