Vue组件库开发中必须启用scoped样式，其通过编译时为元素添加唯一data-v-xxx属性并重写选择器（如.class[data-v-xxx]）实现隔离，确保样式不泄漏、不被干扰、不破坏宿主环境。
Vue 组件库开发中，样式隔离不是可选项，而是必须落地的工程规范。核心目标是：组件自带样式不泄漏、不被外部干扰、不破坏宿主环境——尤其当该组件被集成到任意 Vue 项目（含不同版本、不同构建配置、不同 UI 框架）时，仍能保持视觉与行为一致。
必须启用 scoped 样式
所有组件的 <style> 块默认添加 scoped 属性。这是隔离的基线保障：
- 编译时自动为组件内每个 DOM 元素注入唯一
data-v-xxx属性，并重写 CSS 选择器为.class[data-v-xxx]形式 - 根元素会同时携带自身和父组件的
data-v-*属性，确保布局类（如margin、display）可由父级控制，但内部结构样式完全私有 - 禁用无
scoped的全局<style>，除非明确用于主题变量或 reset 类等极少数跨组件基础层
禁止直接覆盖第三方组件内部样式
组件库自身不应依赖或修改 Element Plus、Ant Design Vue、Vant 等第三方 UI 库的内部类名。若需定制外观：
- 优先使用它们官方支持的插槽（slot）、作用域插槽（scoped slot）或 prop 控制样式（如
size、type、class-prefix） - 确需穿透时，仅在文档明确支持的场景下使用
::v-deep()或:deep()，且必须限定作用域（例如只穿透到.el-button的直接子元素，而非全量button标签） - 避免在组件库源码中写
:deep(.el-input__inner) { border: 1px solid red }这类强耦合样式，它会导致下游项目升级 Element Plus 后样式失效
类名设计遵循 BEM + 命名空间前缀
即使有 scoped，仍需人工规避语义冲突：
立即学习“前端免费学习笔记（深入）”；
- 所有公共类名以组件库统一前缀开头（如
ui-button、ui-modal__header、ui-input--small） - 采用 BEM 规范：块（block）为组件名，元素（element）用双下划线连接，修饰符（modifier）用双短横连接
- 禁用纯功能类名（如
red-text、mt-2），所有样式需表达语义与结构，而非视觉结果
提供 CSS 自定义属性（CSS Variables）接口
面向主题定制，暴露清晰、有限、带文档的 CSS 自定义属性：
- 例如
--ui-button-primary-bg-color、--ui-border-radius-base、--ui-font-size-sm - 在
<style scoped>中通过var(--ui-xxx)使用，不硬编码值 - 配套提供
default-theme.css和dark-theme.css示例，说明如何覆盖
不复杂但容易忽略：样式隔离的本质不是“不让别人改”，而是“让别人能安全地改”。标准落地的关键，在于编译时机制（scoped）、人工约定（BEM+前缀）、运行时接口（CSS vars）三层协同，缺一不可。
