WebStorm编译配置“点OK却消失”的根本原因是静默校验失败：Program路径无效（如eslint未安装或后缀缺失）、Working directory与配置文件位置不匹配、Configuration file格式不被当前版本支持，任一不满足即丢弃配置且不报错。
WebStorm 中编译配置（如 TypeScript、Less、ESLint File Watcher）看似点了 Apply/OK 却“没保存”，根本原因不是 UI 卡顿，而是配置项依赖的底层路径或文件未就绪，导致 WebStorm 拒绝持久化该设置。
为什么点 OK 后配置消失或回退
WebStorm 在保存编译类配置前会做静默校验，任一关键路径无效就会丢弃整个配置——它不会报错，只默默恢复上一版。最常见的是：
-
Program路径填了eslint但项目没装eslint，或填了node_modules/.bin/eslint却没加$ProjectFileDir$/前缀（Windows 下漏掉.cmd后缀也直接失败） -
Working directory设为$ProjectFileDir$，但实际tsconfig.json在子目录，tsc 找不到配置，Watcher 配置被拒绝保存 -
Configuration file指向eslint.config.js，但当前 WebStorm 版本（如 v2025.3）不支持该扁平配置格式，也不提示，只是不存
TS / Less 编译器路径必须指向本地 node_modules
WebStorm 无视全局安装的 tsc 或 lessc，只信任项目级二进制。手动验证是否可用比盲目填路径更有效：
- 在 WebStorm Terminal 运行：
npx tsc -v（确认 TS 可用）、npx lessc -v（确认 Less 可用） - 若报
command not found，先运行：npm install typescript less --save-dev - 再填 Program 路径：
macOS/Linux：$ProjectFileDir$/node_modules/.bin/tsc或$ProjectFileDir$/node_modules/.bin/lessc
Windows：$ProjectFileDir$/node_modules/.bin/tsc.cmd或$ProjectFileDir$/node_modules/.bin/lessc.cmd
File Watcher 的 Output paths to refresh 必须精确匹配输出位置
这个字段不是可选项，是 WebStorm 判断“我该重载哪些文件”的唯一依据。填错会导致配置无法保存，或保存后无反应：
- TypeScript：若
tsconfig.json里有"outDir": "./dist"，则填：$ProjectFileDir$/dist/$FileNameWithoutExtension$.js - Less：若编译目标是
src/css/main.css，则填：$ProjectFileDir$/src/css/main.css（不能只写main.css） - ESLint：
--fix是就地修改，必须填$FilePath$，否则 WebStorm 不知道文件已变，看起来像“没修复”
配置保存后仍不触发？检查 Auto-save 是否启用
File Watcher 默认不响应 Ctrl+S，除非你明确告诉它“保存即触发”。很多人配完就以为万事大吉，其实漏了最关键两步：
- 勾选 Auto-save edited files to trigger watcher（否则改完不保存，Watcher 根本不跑）
- 勾选 Trigger the watcher on external changes（否则 Git checkout 或 CLI 修改后，WebStorm 不感知）
- 注意：这两项在 File Watcher 配置弹窗底部，非默认开启，且没有视觉反馈——不勾就等于没配
真正卡住人的地方，从来不是“怎么点菜单”，而是 WebStorm 把校验失败做成静默丢弃。它不报错、不弹窗、不记日志，只让你反复怀疑自己手抖。每次配完务必用 Terminal 手动跑一遍对应命令，确保路径、权限、参数全通，再回 WebStorm 点 OK —— 这才是能落地的配置闭环。
