Stylelint 能自动修复 Sass 文件，但需安装 stylelint-scss 和 postcss-scss 插件，配置 customSyntax: "postcss-scss" 和 plugins: ["stylelint-scss"]，且仅对 indentation、max-empty-lines 等格式类规则生效，语义类规则不可修复。
Stylelint 能否自动修复 Sass 文件
可以，但默认不启用 —— stylelint 的 --fix 参数只对部分规则生效，且必须确保所用插件和配置支持 Sass 语法解析与修复。很多常见违规（比如缩进、空行、属性顺序）能修，但涉及语义或上下文判断的（如 color-named、declaration-block-no-duplicate-properties 在嵌套中）通常跳过。
需要安装哪些依赖才能修 Sass
仅装 stylelint 不够，它原生只处理标准 CSS。要解析 .scss 或 .sass，必须引入语法扩展：
-
stylelint-scss：提供 Sass 特有规则（如scss/double-slash-comment-empty-line-before），部分支持修复 -
postcss-scss：让 Stylelint 能正确 parse Sass 语法（尤其nesting、&、变量插值等） - 可选：
stylelint-config-standard-scss：开箱即用的推荐配置，已适配修复能力
安装命令：npm install --save-dev stylelint stylelint-scss postcss-scss
配置文件里必须加的关键项
缺了这两项，--fix 很可能静默失败或报错 Cannot read property 'range' of null：
立即学习“前端免费学习笔记（深入）”；
-
customSyntax: "postcss-scss"：告诉 Stylelint 用postcss-scss解析，不是默认的postcss -
plugins: ["stylelint-scss"]：否则scss/*规则不生效，修复也无从谈起 - 确保
rules中启用带修复能力的规则，例如："indentation": 2、"max-empty-lines": 1、"no-eol-whitespace": true
最小可用配置示例（.stylelintrc.cjs）：
module.exports = {
customSyntax: "postcss-scss",
plugins: ["stylelint-scss"],
rules: {
"indentation": 2,
"max-empty-lines": 1,
"scss/at-rule-no-unknown": true,
}
};
执行修复时的典型陷阱
看似运行了 npx stylelint "**/*.scss" --fix，但文件没变？常见原因：
- 路径没匹配到文件 —— 检查 shell 是否支持
**，Windows cmd 默认不支持，改用npx stylelint "src/**/*.scss" --fix或换 PowerShell/Git Bash - 规则本身不可修复 —— 查 官方规则列表，带 ✅ 图标的才支持
--fix；scss/dollar-variable-pattern就不能修 - Sass 嵌套过深或含非法语法（如未闭合的
@if），导致解析失败，--fix直接跳过该文件，连警告都不报 - 编辑器保存后自动格式化（如 Prettier）又把 Stylelint 修好的内容覆盖了 —— 确保 Prettier 关闭 CSS/Sass 处理，或用
prettier-plugin-sass协同
真正稳定的修复流程是：先跑一遍不带 --fix 看报什么错，确认都是可修复规则，再加参数重试；嵌套多的文件建议单个测试，避免批量出错难定位。
