PhpStorm 的 Less 编译依赖本地 lessc 工具，需配置绝对路径、启用 File Watcher 并匹配 **/*.less;**/\_*.less 模式，Arguments 与 Output 必须同步支持 sourcemap，否则 DevTools 无法定位源码行。
PhpStorm 本身不编译 Less，它只是调用你本地的 lessc 命令行工具；配置失败，基本就是路径没填对、watcher 没启用、或 sourcemap 参数漏了。
确认 lessc 已全局安装且路径正确
PhpStorm 启动时不会自动继承终端的 PATH，所以填 lessc 或 lessc.bat 会直接报错 "lessc is not recognized"。
- 先在终端运行
where lessc（Windows）或which lessc（macOS/Linux），拿到绝对路径，例如：C:\Users\Alice\AppData\Roaming\npm\lessc.cmd或/usr/local/bin/lessc -
Program字段必须粘贴这个完整路径，不能加引号，也不能省略.cmd后缀（Windows） - 别用
./node_modules/.bin/lessc这类相对路径——IDE 工作目录不确定，大概率失效 - 验证方式：在 PhpStorm 终端里直接执行该路径，应能输出
lessc版本信息
File Watcher 必须启用，且监听范围包含下划线文件
默认的 **/*.less 不会响应 _variables.less 或 _mixins.less 的修改，而这些文件常被主入口 @import 引入，改了却没触发编译是高频问题。
- 进入
Settings > Tools > File Watchers，勾选左侧复选框，确保状态显示绿色running -
Watch patterns改成：**/*.less;**/_*.less（Sass 同理：**/*.scss;**/_*.scss） - 如果项目结构是
src/less/下放源文件、dist/css/下出 CSS，Working directory应设为$ProjectFileDir$/src/less，否则 watcher 找不到源文件
Arguments 和 Output paths to refresh 必须同步配 sourcemap
没有 sourcemap，DevTools 里点不到原始 .less 行号，不是浏览器设置问题，是这里参数和刷新规则没对齐。
立即学习“PHP免费学习笔记（深入）”；
-
Arguments推荐填：$FileName$ $FileDir$/$FileNameWithoutExtension$.css --source-map --source-map-include-content -
Output paths to refresh必须显式包含 map 文件，例如：$FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map - 注意大小写：
--source-map（Less）≠--sourcemap（旧版 Sass）≠--sourceMap（错） - 如果项目已用 Webpack/Vite，建议直接关掉这个 watcher——两个工具同时监听同一组文件，容易导致 CSS 覆盖、watch 进程卡死
常见静默失败场景与排查顺序
改了 .less 没反应？别重装 Node.js，按这个顺序看：
- 打开
File Watchers列表，确认对应项已勾选，且右侧状态是running（灰色idle= 没生效） - 右键编辑器里的
.less文件 →Reload project from disk，再保存一次，看是否触发 - 检查
Event Log（底部栏），有无红色错误，比如Cannot run program "lessc"或Exit code 1 - 临时把
Arguments简化为$FileName$ $FileNameWithoutExtension$.css，排除参数冲突 - 最后才查 Node.js 版本兼容性——2026 年推荐用 npm 全局安装
less@4.2.0+，旧版lessc对 ESM 支持差，可能解析失败
真正麻烦的从来不是配置步骤，而是 IDE 不报错、也不干活——它只默默跳过所有失败，连日志都懒得记全。盯住 Event Log 和 running 状态，比反复点“Apply”有用得多。
