清除 CLI v0 翻译

删除选定的受管理目录条目,并在重新生成前核实删除范围。

v0 的清除操作会删除受管理的目录条目,但不会像当前 CLI 那样清理文件和锁文件。运行前,请保留可用于恢复的副本:不加筛选的清除操作可能会移除已配置目标中的所有受管理键。

选择一个目标和一个键 #

要清除法语中名称为 app.title 的扁平键:

sh
lingo purge --locale fr --key app.title

接受确认前,请仔细查看确认提示中列出的键和路径。本例中的点号是扁平键名称的一部分;嵌套形式如何表示取决于加载器。

选项0.138.10 选择范围
--bucket json存储桶类型;可重复指定。
--locale fr语言区域代码;可重复指定。
--file messages.json对子字符串进行匹配,匹配对象为已配置的路径模式值。
--key app.title用于匹配解码后受管理键的 Minimatch 模式。
--yes-really跳过交互式确认。

清除操作的匹配器并非 run 使用的、可识别边界的键/前缀匹配器。请核实选定的条目,不要仅依赖有关匹配的帮助说明,也不要直接复制 run --key 选择器。

明确排除源语言区域 #

请对照 locale.source 检查所选语言区域。指定源语言区域也可能删除源内容;--locale 并不保证只选中目标。

首次检查时,请保留确认步骤。只有在自动化流程的确切删除范围已经核实后,才使用 --yes-really。执行成功并不能说明删除范围是否恰当。

重新生成前检查删除结果 #

清除操作会写入目录,但不会重建 i18n.lock。随后执行一次常规运行,就会检测到缺失的目标:

sh
lingo run --target-locale fr

这次运行也可能处理其他待处理的法语更改。请检查源内容的状态和最终差异,不要将其视为仅处理一个翻译请求。

如果重新生成失败,已删除的条目会持续缺失,直到恢复或重新生成。请勿通过修改校验和来模拟删除。对于值未发生变化、只是需要优化措辞的内容,对选定内容强制重新翻译可避免输出暂时缺失的中间状态。