Stylelint 在 WebStorm 中不生效的根本原因是其默认不接管 CSS/SCSS/Less 的 linting，需手动配置本地 stylelint 实例路径、配置文件及文件类型支持，并确保启用相关检查项与重载配置。
Stylelint 检查为什么在 WebStorm 里不生效
根本原因不是 WebStorm 不支持，而是它默认不接管 CSS/SCSS/Less 的 linting —— 它把这块交给了你本地装的 stylelint CLI，但前提是：路径对、配置存在、且 WebStorm 知道该用哪个。常见现象是改了 CSS 文件，编辑器毫无反应，stylelint 命令行却能正常报错。
- 确保项目根目录有
stylelint.config.js或.stylelintrc（哪怕只是空配置） - 必须通过 npm/yarn/pnpm 在项目本地安装
stylelint（全局安装 WebStorm 通常不识别） - WebStorm 默认只检查
.css文件，若用.scss或.less，需手动在Settings → Languages & Frameworks → Stylesheets中启用对应语言支持 - 检查
node_modules/.bin/stylelint是否可执行；Windows 用户尤其注意路径中不能含空格或中文
在 WebStorm 里正确启用 Stylelint 的三步操作
不是勾个开关就完事，关键在于让 WebStorm 找到并信任你的本地 stylelint 实例。跳过任一环节，就会“看起来启用了，实则静音”。
- 打开
Settings → Languages & Frameworks → Stylesheets → Code Quality Tools → Stylelint - 勾选
Enable，然后在Stylelint package字段点文件夹图标，手动定位到项目下的node_modules/stylelint（不是node_modules/.bin/stylelint） - 在
Configuration file中指定配置路径（如stylelint.config.js），并确认Run for files包含你实际写的扩展名（比如加进**/*.scss）
设完别急着写代码 —— 先保存配置，重启 WebStorm，再开一个 .css 文件试试。如果右下角没出现 Stylelint 提示，说明路径或配置加载失败。
Stylelint 报错不提示、不高亮？先看这几点
即使启用成功，也常遇到“有错误但不标红”“Alt+Enter 没修复建议”的情况。这不是插件坏了，而是 WebStorm 的 linting 机制在“选择性沉默”。
立即学习“前端免费学习笔记（深入）”；
- 检查当前文件是否被排除在项目范围外（右键文件 →
Mark as Plain Text会彻底关闭所有检查） - 确认
Settings → Editor → Inspections中，CSS → Stylelint这一项是启用状态（注意：它和上面的Code Quality Tools是两套开关） - 若用 Prettier + Stylelint 组合，确保没在
Settings → Editor → Code Style → CSS里勾选Enable CSS formatter，否则格式化可能覆盖 lint 结果 - 某些规则（如
declaration-block-no-duplicate-properties）在嵌套语法（SCSS）中默认不触发，需在配置里显式开启customSyntax: 'postcss-scss'
想让 Stylelint 在保存时自动修复？得绕开 WebStorm 的限制
WebStorm 内置的 Stylelint 支持只读检查，不支持自动 fix —— 即使你在配置里写了 "fix": true，它也不会执行。这是设计如此，不是你配错了。
- 真正可行的方案是：用 WebStorm 的
File Watchers插件调用npx stylelint --fix - 添加 Watcher 时，
Program填npx，Arguments填stylelint --fix $FilePath$，Working directory设为$ProjectFileDir$ - 务必勾选
Auto-save edited files to trigger the watcher和Trigger the watcher on external changes - 注意：这种方式会在保存瞬间执行 CLI，可能轻微卡顿；若文件大或规则多，建议只对
.css启用，.scss改用编译后检查
最易被忽略的一点：Stylelint 配置变更后，WebStorm 不会自动重载 —— 必须手动点设置页右上角的 Reload configuration 按钮，否则新规则永远不生效。
