Stylelint 在 WebStorm 中默认不工作，需手动配置：本地安装 stylelint、存在有效配置文件、Settings 中指定 node_modules/stylelint 路径（非 .bin）、在 Run for files 中添加 .scss/.less 等扩展名、勾选 Inspections 中的 Stylelint 选项、右键文件标记为 StyleSheet，并重启 IDE。
Stylelint 在 WebStorm 里默认不工作，不是插件没装好，而是它根本没被 WebStorm 主动调用 —— 你得手动告诉它“用哪个 stylelint、检查哪些文件、按什么规则”。
为什么启用了 Stylelint 却没报错？
常见现象是：命令行运行 stylelint src/**/*.scss 能立刻报出 12 个错误，但 WebStorm 编辑器里写完 CSS/SCSS 一行红标都没有。这不是 WebStorm 故障，而是它默认不接管 CSS 类型的 linting，只把这件事“外包”给你本地安装的 CLI 实例，且必须满足三个硬性条件：
- 项目本地安装了
stylelint（npm install --save-dev stylelint），全局安装的stylelint大概率被忽略 - 项目根目录存在有效配置文件（如
stylelint.config.js或.stylelintrc），哪怕内容只是module.exports = {} - WebStorm 的 Settings 中明确指定了
node_modules/stylelint路径，而不是node_modules/.bin/stylelint
怎么在 Settings 里正确填 Stylelint package 路径？
很多人卡在这一步：点开 Settings → Languages & Frameworks → Stylesheets → Code Quality Tools → Stylelint，在 Stylelint package 字段里选了 node_modules/.bin/stylelint，结果重启后依然静音。这是因为 WebStorm 需要的是模块入口，不是可执行脚本。
- 正确路径是：
node_modules/stylelint（Windows 下路径不能含空格或中文） - 必须点右侧文件夹图标手动选择，不能手输；如果选完显示 “Package not found”，说明
stylelint没装在当前项目下，或node_modules还没生成 - Mac/Linux 用户若用 pnpm，路径可能是
node_modules/.pnpm/stylelint@16.9.0/node_modules/stylelint，需展开找真实stylelint包目录
SCSS/Less 文件不被检查？检查 Run for files 设置
WebStorm 默认只对 .css 文件启用 Stylelint，哪怕你项目全用 SCSS，也得手动加扩展名，否则编辑器直接跳过。
立即学习“前端免费学习笔记（深入）”；
- 在同一个 Stylelint 设置页里，找到
Run for files输入框 - 确保包含你实际写的格式，例如：
**/*.css;**/*.scss;**/*.less - 注意分号分隔，不能用逗号；通配符
**表示任意层级子目录 - 改完保存设置，**必须重启 WebStorm**，仅重载配置不生效
报错不标红、Alt+Enter 没修复建议？再查两处开关
即使路径和文件匹配都对了，仍可能“有错不显”——因为 WebStorm 的检查系统有双重闸门。
- 第一道：确认
Settings → Editor → Inspections → CSS → Stylelint是勾选状态（这里独立于上面的 Code Quality Tools 设置） - 第二道：右键当前文件 →
Mark as → StyleSheet，避免被误标为 Plain Text（一旦标记为 Plain Text，所有检查关闭） - 若同时用了 Prettier，禁用
Settings → Editor → Code Style → CSS → Enable CSS formatter，否则格式化会覆盖 lint 结果，导致高亮消失
最常被跳过的其实是重启 IDE 和检查文件是否被标记为 StyleSheet —— 这两个动作看似简单，却是 70% “不生效”问题的终点。别急着怀疑配置，先看右下角有没有出现 Stylelint 提示，没有就回去重走一遍路径 + 重启 + 标记。
