必须安装stylelint-selector-bem-pattern插件并配全preset、componentName、ignoreSelectors三项参数,否则.btn-primary等非BEM写法将漏检;selector-class-pattern仅字符串匹配,无法识别block__element--modifier语义结构。

不能只装 stylelint-selector-bem-pattern 就完事——没配全 preset、componentName、ignoreSelectors 三项,.btn-primary 和 .userList 会完全漏检。
为什么 selector-class-pattern 规则拦不住 BEM 错误
它只是字符串正则匹配,分不清 .card__image(合法)和 .card-image(非法但正则可能放过)。更关键的是:
- 不校验 block 名是否小写开头,
.Card、.USER-card全部放行 - 不识别三层语义结构,对
block__element--modifier中的层级、顺序、连字符数量毫无感知 - 无法拒绝
.header-title这类单连字符写法,也管不了.button__icon--large--v2这种修饰符堆叠
必须填满的三个插件参数
stylelint-selector-bem-pattern 不是“启用即生效”,漏掉任一字段规则就等于没开:
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
-
preset必须显式设为"bem"(不是默认值,填"suit"或留空会导致模式错位) -
componentName推荐正则"[a-z][a-zA-Z0-9]*":强制块名小写开头,禁用.User、.user-list、.user_list -
ignoreSelectors必须显式排除伪类和第三方类,否则.button:hover和.ant-btn全报错;建议值:["/^\..+:(hover|focus|active|disabled|visited)$/", "/^\.ant-.+$/"]
CI 和 pre-commit 中如何真正阻断违规提交
本地 VS Code 提示再准也没用,开发者可以关插件、换编辑器、绕过保存校验。真正在意的只有 CI 和提交钩子:
立即学习“前端免费学习笔记(深入)”;
- CI 脚本里必须加
--max-warnings 0,否则 warning 不阻断合并 - 路径范围建议收窄到新代码区,比如
"src/components/**/*.{css,scss}",老代码用overrides豁免 - pre-commit 钩子别扫全量文件,改用
git diff --cached --name-only --diff-filter=ACM | grep '.css$'只查本次提交的 CSS 文件 - Vue/Svelte 单文件组件里的
<style></style>默认不被检测,必须装对应 processor:stylelint-processor-html或stylelint-processor-svelte,并在配置中声明processor字段
最常被忽略的一点:所有配置都依赖 customSyntax 和对应解析插件(如 postcss-scss + stylelint-scss),漏掉它们,规则会静默失效——连报错都不会触发。

















