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