监视模式:文件变更时自动重新翻译

Lingo.dev CLI 现已支持功能强大的 监视模式,可用于 run 命令。当您的源文件发生变更时,将自动重新进行翻译。

工作原理

当您在 CLI 中使用 --watch 标志运行时,系统会持续监控您在 i18n.json bucket 中配置的源文件。一旦有文件被添加、修改或删除,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 配置中支持的任意文件类型。

何时使用监视模式

  • 在多语言功能的活跃开发阶段
  • 在应用中实时预览翻译变更时
  • 用于本地或云端开发环境的持续集成

提示: Watch 模式专为开发和快速迭代设计。在生产环境或 CI/CD 中,请使用标准的 run 命令,并且不要加上 --watch,以进行一次性翻译。