stylelint保存时自动修复不生效，主因是vs code格式化链路冲突或customsyntax未配置；应关闭editor.formatonsave、启用stylelint.autofixonsave，确保安装官方插件、配置匹配的customsyntax及可修复规则。
Stylelint 保存时自动修复不生效？检查 editorconfig 和插件链路
VS Code 里配了 stylelint.autoFixOnSave 却没反应，大概率不是 Stylelint 本身的问题，而是编辑器插件没接上或被其他格式化工具拦截。VS Code 默认启用 editor.formatOnSave，它会优先调用 Prettier（如果装了），而 Prettier 不认识 CSS 的 @layer 或自定义属性语法，直接跳过，导致 Stylelint 根本没机会运行。
实操建议：
- 关掉
editor.formatOnSave，只开stylelint.autoFixOnSave - 确认已安装
stylelint.vscode-stylelint插件（官方维护，非旧版stylelint） - 在项目根目录放
.editorconfig，避免缩进/换行规则和 Stylelint 冲突（比如indent_style = space要和indentation: "space"一致） - 检查
settings.json是否有"css.validate": false—— 关掉它，否则 VS Code 自带校验会报红，掩盖 Stylelint 的修复提示
配置文件里哪些 rule 能 auto-fix，哪些不能？看文档右上角小图标
Stylelint 官网每个 rule 页面右上角标着 ✅ 或 ❌，只有带 ✅ 的才能自动修复。比如 declaration-block-semicolon-newline-after 可以，但 selector-max-id 或 max-line-length 这类涉及语义判断的，无法安全自动改，只能报错。
常见可修复 rule 示例：
-
indentation：缩进空格数不对，保存即修正 -
string-quotes：单引号强制转双引号（或反之） -
color-hex-case：#FF0000→#ff0000 -
declaration-colon-space-after：冒号后缺空格自动补
别硬给不可修复 rule 加 fix: true —— CLI 或插件会静默忽略，你还以为配错了。
CLI 命令行修复 vs 编辑器保存修复，触发时机和范围完全不同
命令行 npx stylelint "**/*.{css,scss,less}" --fix 是暴力全量扫，适合上线前清理；编辑器保存是增量、单文件、轻量级修复，只处理当前打开的文件，且只走可修复 rule。两者不互斥，但别指望保存时把整个 components/ 目录的缩进全刷一遍。
注意点：
-
--fix不会删掉未声明的自定义属性（如--xxx），也不会合并重复 selector —— 那些得靠postcss-sorting或手动 - 如果项目混用 SCSS 和 CSS，确保
overrides正确匹配扩展名，否则.scss文件可能被跳过 - CI 流程里加
--fix要小心：它会改文件内容，可能造成 diff 意外提交，建议只用于 pre-commit hook 并配合git add
为什么修复后样式还是“看起来不对”？可能是 PostCSS 解析层被绕过了
Stylelint 本身不处理语法转换，它依赖 PostCSS 解析器。如果你用了 postcss-scss 或 postcss-less，但 .stylelintrc 里没配 customSyntax，那嵌套规则、变量、mixin 就解析失败，修复自然失效，甚至报 Unknown word 错误。
例如 SCSS 项目必须写：
module.exports = {
customSyntax: "postcss-scss",
rules: { /* ... */ }
};
否则 &:hover 会被当成非法 selector，@mixin 直接抛错 —— 修复根本启动不了。这个配置漏掉，90% 的“修复无效”问题就出在这儿。
复杂点在于：不同语法（SCSS/Less/CSS-in-JS）要对应不同 customSyntax 包，而且它们的版本要和 Stylelint 兼容。比如 Stylelint v16+ 要求 postcss-scss@4.0.0+，旧版会静默失败。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
