PhpStorm没有原生“保存即编译”功能，本质是File Watcher监听文件落盘后的变更并调用外部命令；需勾选Auto-save edited files to trigger the watcher，且Program路径、Working directory、Scope和Output paths必须严格匹配才能生效。
保存即编译不是 PhpStorm 原生功能
PhpStorm 没有“按 Ctrl+S 就自动编译”的开关。所谓“保存即编译”，本质是 File Watcher 监听文件变更 + 触发外部命令，而触发时机依赖你是否勾选了 Auto-save edited files to trigger the watcher。它不响应“保存动作本身”，而是监听“文件落盘后内容变化”。如果你关了自动保存，改完不手动 Ctrl+S，File Watcher 就永远不会启动。
File Watcher 必须匹配文件路径和工具可执行性
常见失效原因不是配置错，而是根本没跑起来：
-
Program字段必须填绝对路径（如/usr/local/bin/sass）或确保终端里能直接运行该命令（比如sass --version成功） -
Working directory推荐设为$ProjectFileDir$，否则相对路径（如src/main.scss）会解析失败 -
Scope或File type要实际覆盖你编辑的文件：设了**/*.ts却去改.php，自然没反应 - Windows 用户若用 Git Bash/WSL，注意 PhpStorm 默认调用的是 CMD，
Program得写C:\Users\XXX\AppData\Roaming\npm\sass.cmd这类完整路径
只监听特定文件？靠排除，不靠包含
你不能说“只监听 src/**/*.php”，但可以做到等效效果：
- 在
Mappings中把Local path设为整个项目根目录（$ProjectFileDir$） - 在
Excluded paths里填node_modules/**、vendor/**、dist/**等无关目录 - 再用
Scope限定为Project Files或自定义File type（比如只选PHP或TypeScript） - 注意：
Excluded paths只阻止上传或索引，对File Watcher无效——它只靠Scope和File type过滤
编译后文件不被 IDE 识别？Output paths 没对齐
IDE 不知道你生成了什么，就不会刷新、跳转、报错。关键字段必须严格一致：
立即学习“PHP免费学习笔记（深入）”；
-
Arguments中输出目标要和Output paths to refresh完全匹配，例如：
Arguments:--out-dir dist $FileName$→ Output paths:dist/$FileNameWithoutExtension$.js - 别写
**/*.js，那是通配，IDE 不认；必须是具体路径模板，如dist/main.js或dist/$FileNameWithoutExtension$.js - 如果用了
tsconfig.json的outDir，File Watcher不会读它——你得手动抄一遍，否则生成的文件可能被 IDE 忽略 - 修改
_partial.scss不触发编译？正常。Watcher 默认只响应入口文件（不以下划线开头），需手动在 Arguments 里列明所有主入口，或改用项目根目录监听 + 文件类型过滤
真正容易被忽略的点是：File Watcher 启动依赖三个刚性条件同时成立——启用状态、路径匹配、命令可用。少一个，就静默失败，连日志都不打。调试时先在终端手动跑一遍 Program + Arguments，再回头检查 IDE 配置。
