File Watcher 不生效需先启用插件并关闭安全模式；Program 必须填绝对路径或 ./node_modules/.bin/xxx；启用 Auto-save edited files 可实现修改即编译；错误详情查看 Event Log。
File Watcher 不生效？先确认插件已启用且项目非安全模式
WebStorm 的 File Watcher 默认不激活，必须手动启用插件，否则所有配置都只是摆设。打开 Settings / Preferences → Plugins，搜索 File Watchers 并确保勾选——这是 90%「配了没反应」问题的根源。
另一个隐蔽原因：项目以 安全模式（Safe Mode） 打开时，File Watcher 会直接被禁用，连启动日志都不输出。检查右下角状态栏是否有 Safe Mode 提示，如有，请关闭后重启项目。
- 插件路径：
Settings → Plugins → Installed → File Watchers - 安全模式判断：菜单栏
Help → Safe Mode是否打钩；或查看状态栏右下角小图标 - 插件启用后无需重启 IDE，但已打开的项目需重新加载设置（可点
File → Reload project from disk）
用 node-sass 编译 SCSS？别直接填 node-sass，要写完整路径
很多教程说「Program 填 node-sass」，结果报错 Cannot find module 'node-sass' 或 Command not found。这是因为 WebStorm 启动的子进程不继承 shell 的 $PATH，它找不到全局安装的二进制文件。
正确做法是填绝对路径，比如 macOS/Linux 下运行 which node-sass，Windows 下用 where node-sass，把输出结果粘贴进 Program 字段。更稳妥的是用本地 node_modules/.bin/node-sass（项目级安装）。
- 推荐路径写法：
./node_modules/.bin/node-sass（相对路径，跨机器兼容） -
Arguments示例：$FileName$ $FileNameWithoutExtension$.css --output-style compressed --source-map true -
Working directory必须设为$ProjectFileDir$，否则@import会找不到依赖文件 - 如果用了
dart-sass，命令名是sass，参数也不同：--style=compressed --source-map
保存即编译 vs 修改即编译？关键看这个复选框
很多人以为「改完文件自动编译」是默认行为，其实 WebStorm 默认只在「文件显式保存（Ctrl+S / ⌘S）」时触发 File Watcher。想实现「改完就编译」，得打开一个隐藏开关：
在 File Watcher 配置页底部，勾选 Auto-save edited files to trigger the watcher。它会让 IDE 在失焦或达到延迟阈值（默认 500ms）时自动保存脏文件，从而触发监听。
- 开启后可能影响手感：频繁切换标签页也会触发保存+编译，尤其大项目里容易卡顿
- 不建议全局开启，只对
.scss、.ts等需要即时反馈的类型单独启用 - 若同时启用了多个 Watcher（如 SCSS + ESLint），它们按列表顺序依次执行，顺序错可能导致 CSS 编译完但 JS 还没 lint 完
错误提示只显示「Watcher failed」？去 Event Log 看真实报错
File Watcher 出错时，编辑器里往往只标红一行，提示模糊的 Watcher failed，根本看不出哪错了。真正有用的错误信息藏在 Event Log（底部工具栏左起第二个图标，或 Alt+0）里，点开才能看到完整命令、退出码和 stderr 输出。
常见真实错误包括：Permission denied（macOS 上 node-sass 权限问题）、Cannot resolve @import（include-path 没配对）、Unexpected token（SCSS 语法错但未高亮）。
- 调试技巧：复制
Event Log里的完整命令，在终端里手动执行一次，复现并定位问题 - 如果报
EACCES，可能是 npm 全局 bin 目录权限不对，改用项目级./node_modules/.bin/xxx - Watchers 被自动禁用后，不会弹窗提醒，需手动回到
Settings → Tools → File Watchers检查复选框是否被清空
Program 路径和 Working directory 都得重调——这点没人提醒，但几乎每个团队都会踩三次以上。 
