17370845950

根本原因是层叠顺序和源码位置决定最终生效规则，后加载或更具体的样式会覆盖前者；CSS Modules仅隔离作用域，不解决语义一致性；真正有效的是语义化命名、单一入口和CSS自定义属性。

为什么 .btn 在多个 CSS 文件里被反复定义会导致样式失效？

根本原因不是“重复定义”本身，而是层叠顺序（cascade）和源码位置决定最终生效的规则。浏览器不会报错，但后加载、权重更高或更具体的规则会覆盖前面的——你看到的“没生效”，其实是被悄悄替换了。

• 同一选择器在不同 中出现时，后引入的文件优先
• 同一文件中，后面声明的 .btn 规则覆盖前面的（无视顺序只看源码行号）
• .btn:hover 和 .btn 不算重复，但它们共用基础类，容易因局部修改破坏整体一致性

CSS Modules 是不是解决重复定义的银弹？

它能隔离作用域，但只对组件化场景有效，且不解决全局类名冲突本身——比如你仍可能在两个模块里都写 styles.button，编译后变成 Button_button_abc123 和 Modal_button_def456，名字不冲突，但视觉和行为可能不一致。

• 适合 React/Vue 单文件组件，不适合纯 HTML + 外链 CSS 的老项目
• 无法约束设计系统层面的语义一致性（比如 primary 按钮在按钮组件和表单组件里颜色不统一）
• 调试时 class 名变长，DevTools 里看到的是哈希串，排查来源需依赖构建工具支持

真正管用的样式管理三原则

不靠工具封印，而靠约定落地：

• 禁止直接写 .btn 这类泛化类名：改用语义化前缀，如 .c-button（component）、.t-card-header（template）、.u-text-small（utility）
• 所有基础样式必须走单一入口：比如只允许在 src/styles/base.css 里定义 .c-button，其他文件只能用 @import 或构建时注入，不能重写
• 用 CSS 自定义属性替代硬编码值：把 color: #007bff 换成 color: var(--color-primary)，全局色调变更只需改一处变量声明

:root {
  --color-primary: #007bff;
  --space-md: 1rem;
}

.c-button {
  padding: var(--space-md);
  color: var(--color-primary);
  border: 1px solid var(--color-primary);
}

PostCSS 插件能自动发现重复定义吗？

可以，但得选对插件：postcss-discard-duplicates 只删完全相同的规则，对看似重复实则上下文不同的（比如一个在 @media 里、一个不在）无能为力；stylelint 的 no-duplicate-selectors 规则更实用，但它默认只报「完全相同的选择器在同一文件中多次出现」，需配合 stylelint-selector-bem-pattern 等扩展才能识别语义重复。

• 启用前先跑一遍 npx stylelint "**/*.css" --fix，它会自动合并相邻的同选择器规则
• 注意：它不会警告 .btn 和 .button 这种命名差异但功能重叠的情况——这得靠人工 Review 或设计系统文档约束
• CI

  

  流程里加一条检查，比靠人眼盯代码更可靠

实际最难防的不是语法重复，是团队里三个人各自写了 .btn-primary、.primary-btn、.main-button，最后 UI 走样了还互相找不到源头。类名规范和 PR 检查流程，比任何工具都关键。