最稳妥的样式隔离方案是用 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)。问题在于：这些伪类会把样式“打穿”到全局上下文，一旦多个组件都这么写，冲突概率陡增。
立即学习“前端免费学习笔记（深入）”；
更可控的做法是：
- 优先让子组件暴露
classprop，由父组件传入定制类名，而不是反向穿透 - 若必须穿透，限定范围：
: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 ;
关键点：
- 哈希类名只在本模块内生效，即使另一个模块也叫
.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 链和样式抖动就越省力。
