File Watcher 没反应需同时满足三条件：启用状态（Enabled勾选）、文件路径模式匹配编辑文件、工具（如tsc/eslint）可被调用（全局或填绝对路径）。
为什么 File Watcher 没反应？检查这三处硬性条件
PhpStorm 的 File Watcher 不触发，90% 是卡在基础配置没对齐。它不是“装上就跑”，而是依赖三个刚性前提同时满足：
-
File Watcher必须处于启用状态（勾选 Enabled）——很多人改完配置忘了点这个小勾 - 监听的文件路径模式（
Scope或Working directory）必须实际匹配到你正在编辑的文件，比如设了**/*.ts却去改.js文件，自然静音 - 对应工具（如
tsc、eslint）必须能被 PhpStorm 在当前上下文调用到：要么全局可执行，要么在Program栏填了绝对路径（例如/usr/local/bin/eslint），不能只写eslint然后指望它自动找
tsc --watch 和 PhpStorm File Watcher 能共存吗？别混用
能共存，但不建议一起开。两者都监听文件变更并调用 TypeScript 编译器，容易出现重复构建、输出冲突、甚至 TS5055 错误（“Cannot write file because it would overwrite input file”）。
- 如果项目已用
tsc --watch在终端跑着，关掉 PhpStorm 里的TypeScript CompilerWatcher，否则两个进程抢着写.js文件 - 反之，如果靠 PhpStorm 自动编译，就别在终端再起
tsc --watch，尤其注意package.json的scripts里有没有自动启动它的钩子 -
tsc的outDir和 PhpStorm Watcher 的Output paths to refresh必须指向同一目录，否则 IDE 不会自动识别生成文件、无法跳转或高亮报错
怎么让 eslint Watcher 只校验保存后的文件，而不是每次敲字都扫？
默认 Watcher 是“on every save”，但如果你发现敲个 if 就弹 ESLint 报错，说明它被设成了 On type —— 这是性能黑洞，也违背直觉。
- 打开
Settings > Tools > File Watchers，选中你的eslint配置，点Edit - 把
Trigger the watcher on改成On save（不是On type） - 确认
Arguments里没带--fix且Auto-save edited files to trigger the watcher是勾选状态，否则改完不保存，Watcher 压根不启动 - 如果仍卡顿，检查
Working directory是否设为项目根目录；若设成$ProjectFileDir$却在子模块里编辑，可能找不到.eslintrc.js
File Watcher 输出乱码或中文路径报错？环境变量和编码要对齐
Windows 下常见 .js 或 Can't find module 'xxx'，Mac / Linux 上偶发中文路径解析失败，根源几乎全是环境变量或终端编码没继承过来。
立即学习“PHP免费学习笔记（深入）”；
- PhpStorm 启动方式很重要：不要双击图标打开，而是从终端运行
./phpstorm.sh（Linux/macOS）或phpstorm64.exe（Windows CMD/PowerShell），这样才能继承 shell 的PATH和LANG - 在 Watcher 配置页底部勾选
Run in background并取消勾选Show console when warnings or errors occur，否则控制台编码错位会导致命令根本没执行成功，你还以为是工具问题 - Windows 用户特别注意：如果用了 nvm 切换 Node 版本，确保 PhpStorm 启动时加载的是你期望的版本，
which node和 Watcher 里看到的node路径必须一致
最常被忽略的其实是作用域粒度：一个 Watcher 配置生效范围，取决于你设的 Scope（比如 Project Files 还是 lib/**/*.js），而不是“整个项目自动覆盖”。改完配置后，右键某个文件选 Reload project 有时比重启 IDE 更快生效。
