Stylelint 报编码错误需统一转 UTF-8（无 BOM）；识别新 CSS 特性须升级 stylelint ≥ v15.10.0 并配置 customSyntax: 'postcss'；--fix 仅适用于纯格式规则，语义类修复需人工审核；VS Code 中需确保配置文件位于工作区根目录且命名规范。
Stylelint 报 EncodingError 或中文注释乱码怎么办
Stylelint 默认按 UTF-8 解析 CSS 文件，但如果你的项目里混着 GBK、ISO-8859-1 等编码的旧文件（尤其 Windows 下老前端工程），stylelint 会直接报 EncodingError: Failed to decode file 或解析出错的 CSS 规则。
根本原因不是 Stylelint 不支持多编码，而是它不负责自动探测编码——它只认 UTF-8，且不读取文件 BOM 或 @charset 声明（CSS 的 @charset "GBK" 在现代工具链中基本被忽略）。
- 最稳妥的做法：统一转为 UTF-8（无 BOM），用编辑器或命令行批量处理，比如：
iconv -f GBK -t UTF-8 input.css > output.css - 如果必须保留非 UTF-8 文件，可在
stylelint.config.js中加customSyntax配合postcss-load-config做预处理，但实际维护成本高，不推荐 - VS Code 用户注意：
files.encoding设为utf8，并关掉files.autoGuessEncoding——这个选项看似友好，实则会让保存时静默转码，导致团队协作时样式意外变更
如何让 Stylelint 正确识别 @layer、container 等新 CSS 特性
默认安装的 stylelint（尤其是 v14 及更早）用的是较老的 postcss 解析器，不认识 @layer、嵌套 &、container 查询等语法，会直接报 Unknown word 或 Unexpected token 错误。
这不是规则配置问题，是解析层缺失支持。必须升级配套依赖：
立即学习“前端免费学习笔记（深入）”；
- 确保
stylelint≥ v15.10.0（v15.4.0 开始实验性支持，v15.10.0 起稳定） - 显式安装
postcss≥ v8.4.0（stylelintv15 不再内置 PostCSS，必须 peer） - 在
stylelint.config.js中指定customSyntax: 'postcss'（即使没改语法，也要写，否则可能 fallback 到旧解析器） - 若用
postcss-scss或postcss-less，需对应升级其版本，例如postcss-scss≥ v4.0.0 才支持@layer
stylelint --fix 自动修复后样式失效或布局错乱
--fix 不是万能的。它只修「格式」和「可推断的规则」，比如缩进、分号、空格；但对语义类规则（如 color-named、declaration-block-no-duplicate-properties）的修复可能破坏逻辑。
典型翻车场景：
-
color-named开启--fix后，把color: #ff0000改成color: red，结果设计系统里red被重定义为#e53e3e，视觉偏差 -
shorthand-property-no-redundant-values把margin: 10px 20px 10px 20px缩成margin: 10px 20px，但原意是上下/左右分别控制，缩写后变成上下=10px、左右=20px，与预期一致——可万一开发者本意就是写四值强调“非对称”，那自动缩写就掩盖了意图 - 嵌套 CSS 中
&:hover被--fix移到父选择器外，导致层级丢失（因解析器未正确识别嵌套上下文）
建议：只对 indentation、max-line-length、no-eol-whitespace 这类纯格式规则开 --fix；其余规则先人工 review 再决定是否启用。
VS Code 里 Stylelint 提示不生效或总报 No configuration found
不是插件没装，而是 VS Code 的 stylelint 插件默认只在工作区根目录找配置文件，且只认特定名字：.stylelintrc、.stylelintrc.json、stylelint.config.js 等——但不会向上递归查找父目录的配置。
常见断点：
- 你在子文件夹打开 VS Code（比如只打开了
src/css），而stylelint.config.js在项目根目录，插件根本看不到 - 配置文件名是
stylelint.config.cjs或.stylelintrc.yaml，但插件版本太老（ - 用了
stylelint-config-standard-scss，但没装postcss-scss，插件启动时加载失败，静默降级为无配置 - VS Code 设置里
stylelint.enable是false，或者stylelint.packageManager指向了错误的node_modules路径
验证方式：终端进项目根目录运行 npx stylelint "**/*.css"，如果命令行能跑通，问题一定出在插件路径或工作区设置上。
