技能介绍

要解决的问题

开发过程中反复手动执行命令是常见的摩擦点：改完一个 Python 文件，切回终端按 Ctrl+C 停掉旧服务，再重新 python server.py；或者提交前手工跑一遍测试和 linter，漏跑一次就可能把错误带到运行时。这类动作重复而机械，却卡在日常工作流的中间环节。watchexec 针对的正是「文件变了，命令就该重跑」这一高频场景——用独立工具盯住文件系统，在变更发生时自动触发指定命令。

核心能力与工作流程

watchexec 是 Rust 编写的独立文件监视工具，不依赖任何语言运行时，也不绑定特定生态。它的行为可以拆成三步：

监听：递归扫描当前目录及其子目录，捕获文件系统事件；
过滤：遵循 .gitignore 规则，构建产物、依赖目录等无需关注的变更直接忽略；同时对短时间内密集发生的事件做合并（coalesce），避免一次保存触发几十次重跑；
执行：事件触发后自动运行绑定的命令，如 python server.py、单元测试或 linter。

调用方式很直接，不需要 xargs 这类绕人的命令行技巧。典型用法是：当前目录及子目录下任意 Python 文件发生修改时，自动调用（或重启）python server.py。

适用边界与注意点

几点需要留意：watchexec 只负责「监视 + 触发」，不管理命令自身的退出状态，测试失败或服务崩溃后是否重启，取决于命令设计与外层编排；事件合并意味着极短时间内的多次保存会被折叠为一次执行，若脚本依赖逐次触发则不适合。它适用于单元测试、lint 检查、本地开发服务器这类「改完即验」的循环，而不适用于替代 CI 流水线或需要严格串行、有状态的长任务调度。