监视模式:文件更改时的自动重新翻译
Lingo.dev CLI 现在支持 run
命令的强大监视模式,当您的源文件发生更改时,可实现自动重新翻译。
工作原理
当您使用 --watch
标志运行 CLI 时,它会持续监控您配置的源文件(在 i18n.json
的 buckets 中定义)是否发生更改。当文件被添加、修改或删除时,CLI 会自动触发翻译工作流,按需更新目标语言文件和 i18n.lock
。
这非常适合快速开发、实时预览环境或任何需要让翻译与源内容实时同步的工作流。
使用方法
npx lingo.dev@latest run --watch
- CLI 将以监视模式启动,显示检测到的更改和翻译进度的日志。
- 默认情况下,更改会延迟 5 秒处理,以避免快速编辑期间的冗余运行。
- 该进程将持续运行,直到您停止它(Ctrl+C)。
延迟选项
您可以使用 --debounce
标志自定义延迟时间(以毫秒为单位):
npx lingo.dev@latest run --watch --debounce 10000
此示例设置了 10 秒的延迟窗口,用于检测更改与下一次翻译运行之间的间隔。
功能
- 自动重新翻译:在您编辑源文件时即时更新翻译。
- 延迟运行:防止快速文件更改期间的过多翻译请求。
- 错误处理:监视模式能够优雅地处理错误,并在失败后继续监控。
- 支持所有文件类型:适用于
i18n.json
配置中支持的任何文件类型。
何时使用监视模式
- 在多语言功能的活跃开发期间
- 在应用中实时预览翻译更改时
- 与本地或基于云的开发环境进行持续集成时
提示: 监视模式专为开发和快速迭代设计。对于生产环境或 CI/CD,请使用标准的 run
命令而不带 --watch
,以进行一次性翻译运行。