最稳妥的样式隔离方案是用 data-ui 属性限定作用域，配合 CSS Modules 或框架提供的 CSS 变量主题机制。优先通过 data- 属性前缀约束选择器、避免穿透式覆盖、禁用 !important，并利用构建时哈希类名或自定义属性实现天然隔离与动态主题支持。

用 data- 属性隔离框架样式作用域

主流 UI 框架（如 Ant Design、Element Plus）默认使用全局类名，和自定义 CSS 一碰就容易覆盖。最稳妥的解法不是靠权重压，而是从源头切开作用域——给容器加 data-ui="my-app"，再把所有自定义选择器前缀限定在这个属性上。

比如你写一个按钮样式，不要直接写 .btn-primary，而是：

[data-ui="my-app"] .btn-primary {
  background: #007bff;
  border: none;
}

这样即使框架也用了 .btn-primary，它没带 [data-ui="my-app"] 前缀，就不会命中你的规则。Vue/React 组件中可在根元素上统一加这个属性，无需手动维护嵌套层级。

• 避免用 !important 硬顶，它会让后续维护者无法预测样式来源
• 不要依赖框架组件的内部类名（如 .ant-btn），它们属于私有 API，升级可能消失
• data- 属性不参与渲染，不影响性能，且支持 CSS 层叠和 JS 读取

慎用 :global 和 :deep（尤其在 Vue SFC 中）

Vue 单文件组件的 默认会自动添加属性选择器，但遇到需要穿透子组件样式时，开发者常滥用 :deep(.el-input) 或 :global(.highlight)。问题在于：这些伪类会把样式“打穿”到全局上下文，一旦多个组件都这么写，冲突概率陡增。

立即学习“前端免费学习笔记（深入）”；

更可控的做法是：

• 优先让子组件暴露 class prop，由父组件传入定制类名，而不是反向穿透
• 若必须穿透，限定范围：:deep(.el-input):not([data-ui="third-party"]) { ... }
• 避免 :global 直接写顶层选择器，它等价于删掉 scoped，相当于放弃隔离

React 用户同理：不要在 styled-components 里无节制用 & 嵌套或 className 覆盖第三方组件内部结构。

CSS Modules 或 CSS-in-JS 是更彻底的解法

当项目中自定义样式占比高、团队协作频繁时，靠命名约定或属性前缀已不够可靠。CSS Modules 会在构建时把类名哈希化，天然避免冲突：

/* Button.module.css */
.root {
  padding: 8px 16px;
}
.primary {
  background: #0056b3;
}

JS 中导入后使用：

import styles from './Button.module.css';
return Click;

关键点：

• 哈希类名只在本模块内生效，即使另一个模块也叫 .root，编译后也是 _root_abc123 和 _root_def456
• 不支持全局伪类（如 :hover）直接写在外部，需用 &:hover 写在规则内
• 若需局部覆盖第三方组件，可用 composes 继承其 class，而非覆盖

检查框架是否提供 CSS 变量或主题配置入口

很多现代框架（如 Mantine、Chakra UI、Tailwind CSS）已放弃纯 class 覆盖路径，转而提供 CSS 自定义属性接口。例如 Mantine 的 --mantine-color-blue，或 Tailwind 的 theme.colors.primary 配置项。

这类方式的优势是：

• 样式逻辑收口在一处，不会散落在几十个 CSS 文件里
• 支持暗色模式切换、动态主题等进阶需求
• 无需写选择器，自然避开冲突（因为没写 class 名）

务必先查文档：搜索 “CSS variables”、“theme customization”、“override styles”，比手写 .ant-modal-body .my-custom-title 稳定得多。

真正麻烦的从来不是怎么写样式，而是谁在什么时候、以什么优先级改了哪条规则。越早用作用域隔离和变量抽象，后期排查 !important 链和样式抖动就越省力。