CKEditor5多语言同步机制中的核心包翻译问题解析

在CKEditor5的开发过程中，多语言支持是一个重要特性。开发团队通过yarn run translations:synchronize命令来同步不同语言包的翻译内容。然而，最近发现了一个值得注意的问题：当在商业版(Commercial)仓库中执行同步命令时，会意外修改核心(Core)仓库中的翻译文件。

问题现象

当开发者在CKEditor5核心仓库和商业版仓库中先后执行翻译同步命令后，核心仓库的翻译文件（如pl.po）会被意外修改。这些修改主要涉及日期相关的翻译条目，如星期名称（Monday/Tuesday等）和相对时间描述（Yesterday/Today等）。

技术背景

CKEditor5的翻译系统采用以下机制：

1. 翻译内容存储在.po文件中
2. 核心包(ckeditor5-core)包含基础翻译
3. 商业版包可能扩展或覆盖这些翻译
4. 同步命令会扫描源代码中的翻译标记并更新.po文件

问题根源

深入分析后发现，这些日期相关的翻译虽然在核心包中定义，但实际上只在商业版功能中使用。这种"定义与使用分离"的情况导致了同步命令的异常行为：

1. 核心包定义翻译但未使用
2. 商业版使用这些翻译但定义在核心包
3. 同步命令在商业版运行时发现未记录的翻译使用
4. 系统尝试在核心包中补全这些翻译条目

解决方案

开发团队采取了最合理的修复方案 - 将翻译定义迁移到实际使用它们的商业版包中。这种重构：

1. 保持了翻译定义与使用的一致性
2. 消除了跨仓库的意外修改
3. 使翻译管理更加模块化
4. 提高了代码的可维护性

经验总结

这个案例为大型项目中的国际化管理提供了重要启示：

1. 翻译定义应靠近使用点：避免在核心包中定义只在扩展包中使用的翻译
2. 注意跨仓库依赖：当功能跨越多个仓库时，需要特别考虑资源管理
3. 自动化工具的边界：同步工具需要明确其作用范围，避免跨边界操作

通过这次修复，CKEditor5的多语言支持机制变得更加健壮，为未来的国际化工作奠定了更好的基础。