stylelint-selector-bem-pattern插件必须完整配置preset、componentName、ignoreSelectors三项参数，否则无法识别BEM语义错误；它依赖语义解析而非正则匹配，能校验块定义存在性、禁用驼峰/大写Block名、拒绝非法嵌套，并需配合processor处理Vue/Svelte单文件组件。
stylelint-selector-bem-pattern 插件必须装、必须配全三项参数，否则 .btn-primary、.userList、.CardHeader 全部零报错——它不是开箱即用的规则，而是独立插件，不手动干预就等于没开。
为什么 selector-class-pattern 规则拦不住 BEM 错误
它只做字符串正则匹配，完全不理解 BEM 的语义结构：
- .card-footer 和 .card__footer 可能同时通过同一正则
- .card__image__icon（非法三级嵌套）不会被拒绝
- .Card__title（Block 名大写）或 .userAvatar__icon（Element 驼峰）默认不报错
- 完全无法验证 .card__footer 是否真有对应 .card 块定义
stylelint-selector-bem-pattern 必填的三个配置字段
少一个，规则就形同虚设：
- preset 必须是字符串 "bem"，不能留空、不能写成 "suit" 或 "css-modules"
- componentName 必须为 "[a-z][a-zA-Z0-9]*"，强制 Block 小写开头、禁大写/下划线/连字符，否则 .UserCard 或 .user-card 会被放过
- ignoreSelectors 是必填数组，不是可选项：至少包含 "/^\..+:(hover|focus|active|disabled|visited)$/"（注意双反斜杠转义），否则 .button:hover 直接标红；第三方类名如 ant-btn 也建议加 "/^\.ant-.+$/"
Vue/Svelte 单文件组件里没报错？不是插件失效，是没扫描到
stylelint 默认只处理 .css、.scss 等独立样式文件：
- Vue 项目需安装 stylelint-processor-html：npm install --save-dev stylelint-processor-html
- 配置中加 processor: 'stylelint-processor-html'
- VS Code 中确认当前 .vue 文件语言模式是 Vue（不是 HTML），否则扩展不触发
- Svelte 同理，换用 stylelint-processor-svelte
pre-commit 钩子里只检查本次改动的 CSS 文件
跑 stylelint "**/*.css" 不仅慢、易崩溃，还会把历史问题一并翻出来，掩盖真正要提交的违规代码：
- 脚本开头先 cd $(git rev-parse --show-toplevel) 切到仓库根目录
- 用 git diff --cached --name-only --diff-filter=ACM | grep '.css$' 提取暂存区 CSS 文件
- 管道传给 stylelint，例如：xargs stylelint
- 绝对不要加 --fix：它改完不 git add，下次提交照样失败
真正卡住 BEM 规范落地的，从来不是工具能力，而是 componentName 正则是否禁掉大写字母、ignoreSelectors 是否覆盖了伪类和第三方类名——这两处写错，整条规则就等于关掉了。
