Lingo 清理

确认源消息不再使用后,移除过时的 JSONC 目录条目。

消息从源代码中移除后,提取过程会将对应的目录条目标记为孤立条目。lingo clean 会移除这些源条目,以及当前源消息集中已不存在的目标键。它只修改条目,不会删除整个语言区域文件,也不会翻译缺失的值。

先确认是否应当移除 #

运行提取,检查警告和孤立条目。动态调用或解构调用可能无法再被识别,但应用仍在使用它们。此时应修复提取问题,而不是删除仍然需要的消息。

清理前,请保留可用于还原的差异记录。此命令会立即重写源 JSONC 目录及所有检测到的目标 JSONC 目录,不支持试运行、确认标志或按目标语言区域筛选。

sh
lingo clean --source-locale en

--source-locale 默认为 en。--out 优先于配置中的 i18n.messagesPath,其次使用 locales;路径均相对于项目根目录解析。源 <locale>.jsonc 必须存在且非空,否则命令会失败,并提示先运行提取。

完成目录维护 #

查看报告中源目录和各目标目录的条目移除数量,然后检查差异。清理不会重新生成 TypeScript 声明。请使用相同的路径和源语言区域运行 extract 和 check,再运行应用的检查。

如需主动删除目标文件或基线,请使用 purge。如需清理孤立的目录条目,请使用 clean。