WebStorm 底部“scanning files to index”是文件索引进程，非编译进度；卡顿主因是未排除 node_modules 等大目录，右键目录→Mark Directory as→Excluded 即可解决。
WebStorm 底部进度条显示的是文件索引（scanning files to index），不是编译进度
WebStorm 本身没有“编译进度条”这个概念——它不编译代码，只调用外部工具（如 sass、tsc、lessc）执行构建。底部持续滚动的进度条几乎全是 scanning files to index，属于 IDE 自身的索引行为，和你写的 Sass/TS/JS 是否正在编译无关。
常见误解是：改了 _variables.scss 没立刻出 CSS，就盯着进度条等“编译完成”。其实这时候 IDE 可能正卡在扫描 node_modules 或某个大目录，根本没走到 File Watcher 那步。
- 索引卡顿最常发生在未排除的大型目录（如
node_modules、dist、build、.git） - 右键该目录 →
Mark Directory as→Excluded，或进Settings > Directories手动添加排除路径 - 排除后重启 WebStorm，索引速度通常从几分钟降到几秒，底部进度条不再“常驻”
真正影响“保存即编译”的是 File Watcher 是否触发成功
如果你配置了 Sass/Less/TypeScript 的 File Watcher，但改完文件后没生成 CSS/JS，不是进度条没走完，而是 Watcher 根本没启动。WebStorm 不会弹窗报错，只在 Event Log（底部左侧小图标）里闪一下错误信息，极易被忽略。
- 检查
Settings > Tools > File Watchers中对应 watcher 是否勾选了Auto-save edited files to trigger watcher - 确认
Watch patterns包含下划线文件（如**/*.scss;**/_*.scss），否则_mixins.scss修改不会触发 -
Program字段必须填对：全局安装填sass，项目局部安装填$ProjectFileDir$/node_modules/.bin/sass（macOS/Linux）或$ProjectFileDir$\node_modules\.bin\sass.cmd（Windows） - 终端能跑
sass --version≠ WebStorm 能调用它；macOS/Linux 用户常因 PATH 不一致失败，需在 WebStorm 启动脚本里补export PATH="/opt/homebrew/bin:$PATH"
想看真正的编译输出，得盯 Run 窗口，不是底部状态栏
File Watcher 执行时，日志默认输出到 Run 工具窗口（快捷键 Alt+4）。如果编译失败，这里会显示完整命令和报错，比如：
sass src/main.scss dist/main.css --source-map --load-path=node_modules Error: Can't find stylesheet to import. ┌──> src/main.scss 1 │ @use "bootstrap" as bs;
而底部状态栏只会安静地缩成一条细线（尤其在 New UI 下），连“Indexing…”都不显示——它根本不负责汇报编译结果。
- 务必打开
Run窗口并保持可见，改完文件后第一时间扫一眼有没有红色报错 - 如果
Run窗口空空如也，说明 Watcher 压根没运行：检查是否保存了文件、是否触发了 auto-save、是否被排除目录挡住了监听路径 - 不要依赖状态栏视觉反馈来判断编译成败；它连“正在编译 Sass”这种提示都不会显示
容易被忽略的硬伤：source map 缺失导致你以为“没编译”，其实是浏览器没映射
即使 CSS 文件生成了、Run 窗口也没报错，你在 Chrome DevTools 里点样式却跳不到 main.scss，大概率是 File Watcher 没配 --source-map 参数，或者 Output paths to refresh 漏了 $FileNameWithoutExtension$.css.map。
这时候你会误以为“WebStorm 没编译”，反复检查进度条，其实编译早就完成了——只是少了 source map，调试体验断层。
-
Arguments必须显式加--source-map（注意是两个短横线，不是--sourcemap） -
Output paths to refresh必须填两行：$FileNameWithoutExtension$.css和$FileNameWithoutExtension$.css.map，缺一不可 - Chrome 需手动开启：DevTools → Settings → Preferences → Sources → ✅ Enable CSS source maps
状态栏不显示这些细节，它只管索引；真正决定你能不能高效调试的，是这三处配置是否严丝合缝。
