很多人以为只要打开了 File Watcher，按 Ctrl+S 就能自动触发代码检查。但事实并非如此——这中间有一个关键的隔阂。Save files on frame deactivation 和 File Watcher 是两套完全独立的机制，前者负责窗口失焦时自动保存到磁盘，后者则需要你明确告诉它“在保存时触发”。因此，光开启 File Watcher 没有用，还必须配置好触发条件。
Save files on frame deactivation 和 File Watcher 是两套独立机制
按 Ctrl+S 保存文件本身并不会自动触发 File Watcher，除非你明确配置了“On save”触发条件。很多人误以为启用 File Watcher 就会响应保存动作，其实默认可能是 On type 或 Externally changes，根本不会管你按没按保存键。说白了，就是“你按了保存键，但 Watcher 不一定理你”。
关键点在于，File Watcher 的触发逻辑和 PhpStorm 的自动保存开关（比如 Save files on frame deactivation）完全是两码事。前者监听的是文件系统事件或 IDE 操作事件，后者只是把内存里的内容同步到磁盘上。所以，别指望它们自动配合。
On type：每敲一个字符就跑一次，性能差、易误报，且不依赖保存动作On save：仅在用户主动执行保存（Ctrl+S或菜单 Save）后触发，这才是你要的“按保存键自动运行”Externally changes：只响应磁盘文件被外部程序修改（比如 CLI 运行tsc），和 IDE 内操作无关
如何让 File Watcher 真正响应 Ctrl+S
那怎么让 File Watcher 乖乖响应 Ctrl+S 呢？很简单，打开 Settings > Tools > File Watchers，选中你的 watcher（比如 eslint 或 php-cs-fixer），点击 Edit：
- 确认
Enabled已勾选（最外层开关） - 在
Trigger the watcher on下拉菜单中，必须选On save - 确保
Auto-save edited files to trigger the watcher勾选状态 —— 这个选项决定：如果你改完没手动Ctrl+S，Watcher 是否帮你先保存再执行；关掉它，就真得靠你按保存键 - 检查
Scope是否覆盖目标文件，例如设成Project Files或自定义 pattern：**/*.php
如果仍不触发，用终端执行 ls -l your-file.php 确认修改时间是否随 Ctrl+S 更新 —— 若没更新，说明根本没保存成功，File Watcher 自然不会启动。
为什么改了设置还是不运行？常见卡点
别以为设置对了就万事大吉，这几个坑才是真正的拦路虎：
Power Save Mode开启：顶部菜单栏显示该字样时，所有后台任务（包括 File Watcher）全部暂停- 文件被标记为只读：右下角出现锁形图标，
Ctrl+S实际未写入磁盘，Watcher 拿不到变更事件 - Program 路径错误：比如填了
eslint却没全局安装，或没填绝对路径（/usr/local/bin/eslint），IDE 执行失败但不弹窗，只记进idea.log - Working directory 设错：例如设成
$FileDir$，但.eslintrc.js在项目根目录，导致找不到配置文件而退出
验证方式：打开 Help > Show Log in Explorer，搜索 file watcher 或对应工具名（如 eslint），看是否有 exit code 1 或 command not found 类错误。
和保存时格式化（Reformat code）共存要注意什么
如果同时启用了 Tools > Actions on Save > Reformat code，顺序会影响结果：
- PhpStorm 默认先格式化、再触发 File Watcher —— 所以你看到的是格式化后的代码被 lint 或 fix
- 但若格式化器（如
php-cs-fixer）和 File Watcher 都干同一件事（比如调整空格），可能重复处理甚至冲突 - 更麻烦的是：如果
Reformat code改了 import 排序，而你的eslintWatcher 又启用了--fix，两者可能互相覆盖
建议做法：关掉 Reformat code，把格式化逻辑全交给 File Watcher（例如用 php-cs-fixer Watcher 替代内置格式化），避免规则打架。尤其当团队统一用 CS Fixer 时，IDE 内置格式化反而成为干扰源。
真正起作用的从来不是“设置了就能跑”，而是保存动作是否真实落盘、Watcher 是否匹配到文件、工具能否被调用——三者缺一不可。最容易忽略的是只读状态和 Power Save Mode，它们会让一切配置形同虚设。
