Stylelint在WebStorm中不报错，90%因未正确加载项目实例：需手动指定node_modules/stylelint目录路径、在Run for files中添加.scss/.vue等扩展名、配置文件用绝对路径、SCSS项目启用stylelint-scss插件，并右键文件标记为StyleSheet。
Stylelint package路径填错：必须指向node_modules/stylelint目录
WebStorm 不认 node_modules/.bin/stylelint，哪怕它能直接在终端运行。它要的是模块入口目录，不是可执行脚本——选错就等于没装。
- 打开
Settings → Languages & Frameworks → Stylesheets → Code Quality Tools → Stylelint - 勾选
Enable，点击Stylelint package右侧文件夹图标 - 手动导航到项目下的
node_modules/stylelint（Windows 路径不能含空格或中文） - 如果显示
Package not found，先在终端运行npx stylelint --version；报错说明node_modules没装全，或Settings → Languages & Frameworks → Node.js指向的 Node 版本不对
Run for files没加扩展名：SCSS/Vue 文件默认不检查
默认只匹配 **/*.css，哪怕整个项目全是 SCSS，不改这里就完全静音。
- 在同一个设置页中，找到
Run for files输入框 - 填入：
**/*.css;**/*.scss;**/*.sass;**/*.less;**/*.vue（注意用分号分隔，不是逗号） - Vue 文件还需额外确认：
stylelint.config.js中启用了customSyntax: 'postcss-html'或'stylelint-processor-styled-components'，且已安装对应包 - 改完必须重启 WebStorm —— 配置不会热重载
Configuration file路径不对或配置无效
WebStorm 不完全依赖自动查找，尤其当项目有多个配置文件时容易误读根目录外的配置。
-
Configuration file字段手动填：$ProjectFileDir$/stylelint.config.js（或.stylelintrc.json等合法名称） - 确认该文件用
module.exports = { }导出，不是export default（ESM 项目慎用.mjs） - 如果用了
extends: ["stylelint-config-standard"]，检查node_modules/stylelint-config-standard是否存在；CI 报Cannot find module就是这里断了 - 推荐用
.stylelintrc.js而非 JSON：支持注释、环境判断、动态导入，避免规则静默失效
文件类型未标记为 StyleSheet：右键标记这步不能跳过
即使所有配置都对，也要右键当前样式文件 → Mark as → StyleSheet（不是 Plain Text），否则 WebStorm 直接跳过 linting 流程。
立即学习“前端免费学习笔记（深入）”；
- 这个标记状态不会继承，每个新创建的
.scss或.vue文件都得手动确认一次 - 若文件被标记为
Plain Text，右下角不会出现 Stylelint 提示，Alt+Enter 也无修复建议 - 同时检查
Settings → Editor → Inspections → CSS → Stylelint是否启用 —— 这和上面的 Code Quality Tools 是两套开关
