file watcher 不生效主因是插件未启用或项目处于安全模式；需启用file watchers插件、关闭safe mode、正确填写program真实路径、勾选auto-save edited files、设置working directory为$projectfiledir$。
File Watcher 不生效？先检查插件是否启用、项目是否处于安全模式——这两点占了实际问题的九成以上。
File Watcher 插件没开，所有配置都白搭
- WebStorm 默认不启用
File Watchers插件，哪怕你配了一堆规则，它也不会跑 - 进入
Settings / Preferences → Plugins，搜索File Watchers，确保勾选（不是“已安装”就行，必须“已启用”） - 启用后不用重启 IDE，但已打开的项目要手动刷新：点击
File → Reload project from disk - 如果右下角状态栏显示 Safe Mode，立刻关掉：菜单栏
Help → Safe Mode取消勾选，然后重启项目
Program 字段填错路径，node-sass 或 sass 就会报错
- 直接填
node-sass或sass会失败，因为 WebStorm 的子进程不读 shell 的$PATH - 正确做法是填可执行文件的真实路径：
- macOS/Linux：终端运行
which node-sass，把输出粘贴进Program - Windows：命令行运行
where node-sass，复制结果
- macOS/Linux：终端运行
- 更推荐用项目级路径：
./node_modules/.bin/node-sass（对sass同理：./node_modules/.bin/sass） - 注意参数差异：
-
node-sass：用--output-style compressed --source-map true -
sass（Dart Sass）：用--style=compressed --source-map
-
修改即编译？关键在 Auto-save edited files 这个开关
- 默认行为是「仅保存时触发」，不是「改完就编译」
- 想实现修改即响应，必须勾选配置页底部的
Auto-save edited files to trigger the watcher - 勾选后，IDE 会在编辑器失焦或延迟 500ms（默认）后自动保存脏文件，从而触发监听
- 风险点：
- 切换标签页频繁时，可能意外触发大量编译
- 大型 SCSS 项目里，连续保存会导致卡顿甚至崩溃
- 若只想对特定文件生效，建议把
Scope改为Current file或自定义范围，别用全项目
Working directory 设错，@import 就会找不到文件
-
Working directory必须设为$ProjectFileDir$，不能留空或填$FileDir$ - 否则
@import "variables"这类相对路径会从当前文件所在目录开始找，而不是项目根目录，90% 的file to import not found错误都源于此 - 如果用了
includePaths（比如--include-path src/styles），也要确保路径基于$ProjectFileDir$计算，否则照样失效
真正麻烦的不是怎么配，而是配完以为好了，结果改了文件没反应——多数时候只是插件没开、路径不对、或者人在安全模式里浑然不觉。
