Stylelint在WebStorm中不报错，90%因未正确加载项目实例：需手动指定node_modules/stylelint目录路径、在Run for files中添加.scss/.vue等扩展名、配置文件用绝对路径、SCSS项目启用stylelint-scss插件，并右键文件标记为StyleSheet。
WebStorm 里 Stylelint 不报错，90% 是因为没让 IDE 正确加载你项目里的 stylelint 实例——不是插件没装，而是它根本没被调用。
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.js 版本不对
Run for files 必须显式包含 .scss、.vue 等扩展名
默认只匹配 **/*.css，哪怕你整个项目全是 SCSS，不加配置也完全静音。
- 在同一个设置页中，找到
Run for files输入框 - 填入：
**/*.css;**/*.scss;**/*.sass;**/*.less;**/*.vue（注意用分号分隔，不是逗号） - Vue 文件需额外确保已安装
stylelint-processor-styled-components或postcss-html，并在stylelint.config.js中启用对应customSyntax - 改完必须重启 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就是这里断了 - SCSS 项目必须加
plugins: ["stylelint-scss"]，否则会报unknown word
最容易被忽略的是：即使所有配置都对，也要右键当前样式文件 → Mark as → StyleSheet（不是 Plain Text），否则 WebStorm 直接跳过 linting 流程。这个标记状态不会继承，每个新文件都得确认一次。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
