lingo purge

预览将删除的目标文件,了解哪些 Lockfile 条目会随之移除。

lingo purge 用于主动删除派生的目标文件。常规文件模式会预览所选路径;--yes 则执行删除。使用 --file 或 --locale 时,仅移除所选目标及其 Lockfile 条目,保留源文件基线和其他目标的条目。不使用筛选条件时,还会移除整个项目的 Lockfile。

预览普通目标 #

对于采用独立文件的 JSON 布局:

sh
lingo purge --locale de --file locales/en.json

请确认报告中的目标确实是打算删除、无需保留的文件。添加 --yes 前,请保存已认可的输出。如果后续重新生成失败,文件也已被删除。

选项行为
--locale <locale>可重复指定的目标筛选条件;默认使用已配置的目标。不接受源语言区域。
--file <value>可重复指定的源路径筛选条件,或通配符条目对应的具体源路径。
--lockfile-only仅移除 .lingo/lock.json;需要 --yes,且不能与 --file 或 --locale 同时使用。
--yes, -y执行删除,而非文件模式下的预览。

不接受项目根目录之外的派生路径,包括通过符号链接指向根目录之外或 .git 内部的路径;即使未使用 --yes,清除操作也会报告这些路径。根目录内的文件也可能是有价值的源文件或共享数据,因此不仅要检查文件位置,还要确认其用途。

文件选择 #

清除操作根据配置中的具体源路径和具体的 --file 值推导路径。除非提供具体源路径,否则会跳过配置中的通配符条目。对于具体的配置条目,--file 按子字符串筛选,并不执行通用的通配符展开。

清除操作会跳过路径与源路径相同的目标,并提示其译文存储在源文件中。共享的 XCStrings 目录采用这种布局,因此清除操作无法从中移除单个语言区域。请改用 字符串目录修正工作流。

Lockfile 变更 #

带筛选条件的清除操作会移除所选目标的条目,即使这些目标文件已不存在。源文件哈希值会被保留,以便尚未处理的源文件变更仍能在后续推送时应用到其他语言。如果 Lockfile 格式有误,带筛选条件的清除操作会在删除任何目标之前停止;请先还原或修复该文件,再重试。

不带筛选条件的 lingo purge --yes 和 lingo purge --lockfile-only --yes 会移除整个 Lockfile。仅处理 Lockfile 时,若未使用 --yes,则需要确认,而不会生成常规文件预览。

缺失 Lockfile 会改变增量处理计划,但不保证模型会生成全新输出,因为服务器端复用是独立机制。对于普通的缺失文件,请使用回填。对于过时的 React 条目,请使用清理。对于中断的任务,请先进行恢复,同时保留可用状态。