Stylelint默认不解析SCSS/LESS嵌套语法,需显式配置customSyntax(如postcss-scss)、使用对应规则集(如stylelint-config-standard-scss)、启用editor.codeActionsOnSave并关闭editor.formatOnSave,且嵌套相关规则(如selector-nest-limit)本身不可自动修复。

为什么 stylelint.autoFixOnSave 对嵌套规则没反应
Stylelint 默认不解析 SCSS/LESS 的嵌套语法(如 &:hover、@media 块内嵌套),除非你显式告诉它“这是 SCSS/LESS,不是纯 CSS”。插件会把 .less 文件当普通 CSS 解析,导致 selector-nested-pattern、scss/selector-nest-limit 这类规则根本不会触发,更别说自动修复。
必须在项目配置中指定 customSyntax,且该语法解析器要支持嵌套语义。官方 postcss-scss 和 postcss-less 是唯一被 Stylelint 官方文档推荐的选项。
- 安装对应解析器:
npm install --save-dev postcss-scss postcss-less - 在
stylelint.config.js中声明:customSyntax: "postcss-scss"(SCSS)或"postcss-less"(LESS) - VS Code 插件只会读取项目级配置里的
customSyntax,settings.json 里设无效
stylelint-config-standard-scss 和 stylelint-config-standard 别混用
直接 extends stylelint-config-standard 检查 LESS/SCSS 文件,会导致大量误报:比如把 $color 当作非法属性、把 @mixin 当作未知 at-rule、把嵌套选择器识别为 selector-no-qualifying-elements 错误。这不是 Stylelint 有问题,是规则集根本不认识预处理器语法。
- SCSS 项目必须用
stylelint-config-standard-scss(它内置了scss/*规则,并禁用了与变量/嵌套冲突的原生 CSS 规则) - LESS 项目用
stylelint-config-standard-less,别指望standard-scss兼容 LESS - 如果要用属性排序(如
order/declaration-block-order),得额外装stylelint-order插件并启用,否则嵌套块内的属性顺序不会被校验
保存时自动修复嵌套相关错误,只靠 editor.codeActionsOnSave
VS Code 1.84+ 已彻底弃用 stylelint.autoFixOnSave,继续写它等于没配。现在唯一有效路径是 editor.codeActionsOnSave + 显式开启 source.fixAll.stylelint。
- 在
settings.json中加:"editor.codeActionsOnSave": { "source.fixAll.stylelint": true } - 必须同时关掉
"editor.formatOnSave": false,否则 Prettier 或内置 CSS formatter 会抢先格式化,跳过 Stylelint 修复 - 只对当前打开的文件生效——改一个
.less文件,不会顺手修components/下所有嵌套层级;想全量修复,得跑 CLI:npx stylelint "**/*.less" --fix
嵌套深度、命名模式这类规则,--fix 本身就不支持
Stylelint 官网每个 rule 页面右上角标着 ✅ 或 ❌,scss/selector-nest-limit、scss/dollar-variable-pattern、scss/at-rule-nested-empty-line-before 全是 ❌。它们只能报错,不能自动修复——因为“怎么改”需要人工判断逻辑层级是否合理。
- 能自动修复的只有格式类规则:比如
declaration-colon-space-after(补冒号后空格)、at-rule-name-case(转小写@media)、string-quotes(统一引号) - 遇到
Expected selector to be nested within "&"报错?别指望保存就变&:hover,得手动改 - CI 或 pre-commit hook 里加
--fix要格外小心:它不会动嵌套结构,但可能误删你手动写的空行或注释,尤其和postcss-sorting配合时
嵌套语法的校验链很脆弱:语言模式识别 → customSyntax 加载 → 规则集兼容 → 可修复规则筛选。任一环断开,保存时就静默失败。最常被忽略的是右下角语言模式——点开看到的是 “Less”,不是 “LESS” 或 “less”,大小写不对,stylelint.validate 就直接跳过这个文件。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











