真正生效的方式只有两种：运行时用 css 变量覆盖或编译时用 scss 变量重写；css 变量需在 :root 定义且避开伪元素限制，scss 覆盖必须用 @forward+@use 并配 importstyle: 'sass' 确保源码参与构建。
直接改 element-plus/dist/index.css 无效，也不该硬写 CSS 覆盖；真正生效的方式只有两种：运行时用 CSS 变量覆盖，或编译时用 SCSS 变量重写——选哪种，取决于你是否需要热更新、是否用到了按需导入、以及是否在 Vite 或 Webpack 中正确配置了源码路径。
用 CSS 变量覆盖主题色（适合快速验证/运行时换肤）
Element Plus 内部大量使用 --el-color-primary 这类原生 CSS 变量，改它们能立刻生效，无需重新编译。
- 必须在
:root或组件根容器上定义，否则作用域不够 —— 比如只在某个<div class="my-table"> 里设 <code>--el-color-primary，el-button不会响应 - 常见变量名要记准：
--el-color-primary（主色）、--el-border-radius-base（基础圆角）、--el-font-size-base（基础字号） - 政务项目实测：把
--el-color-primary改成#165DFF后，所有el-button、el-input的边框和 hover 色自动同步，但el-table的 hover 行背景色仍需额外设--el-table-row-hover-bg-color - 注意兼容性：CSS 变量无法动态影响伪元素生成的内容（比如
el-select下拉箭头的 SVG fill），这类得靠 SCSS -
@forward必须放在自定义文件最顶部，且只能写一次 —— 如果你先@use 'xxx'再@forward，Sass 会报 “@use rules must be written before any other rules” - 覆盖写法必须用 map 结构：
$colors: ('primary': ('base': #169BFA))，不能简写成$colors: (primary: #169BFA)，否则编译失败 -
@use 'element-plus/theme-chalk/src/index.scss' as *这行不能省，且必须加as *，否则混合宏（如el-text-ellipsis）不可用 - Vite 配置里
additionalData要指向你的自定义文件，不是index.scss本身 —— 错写成@use 'element-plus/...' as *就等于没覆盖 -
ElementPlusResolver必须显式传参：importStyle: 'sass'，否则插件会忽略你的@forward文件 - 若同时用了
unplugin-element-plus，还需开启useSource: true，否则它仍走 dist 路径 - 错误现象：SCSS 文件写得完全正确，但浏览器里看到的还是
#409eff—— 这几乎 100% 是插件没配importStyle - 验证方法：打开开发者工具 → Elements → 找一个
el-button，看 computed styles 里的background-color是来自index.css还是来自你自定义的 SCSS 文件 - 不要在
main.js里import 'element-plus/dist/index.css'，也不要再@use 'element-plus/...'—— 这会导致重复引入、变量冲突甚至 Sass 报 “duplicate module” - 如果启用了自定义命名空间（比如
namespace="ep"），SCSS 里必须同步改$namespace: 'ep'，且@forward要指向config.scss而不是var.scss - 常见坑：在
src/assets/styles/index.scss里既@use了自定义主题，又@import了第三方 CSS 库，结果第三方样式覆盖了你的--el-color-primary - 最稳妥做法：整个项目只在一处引入主题文件（如
src/assets/styles/element.scss），并在vite.config.ts的css.preprocessorOptions.scss.additionalData中全局注入
@forward + @use 覆盖 SCSS 变量（适合深度定制/构建时确定主题）
这是唯一能彻底替换颜色体系、间距、圆角等底层规则的方式，但必须严格遵循 Sass Modules 规范，否则变量根本不会被注入。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
按需导入时主题不生效？检查 importStyle: 'sass'
用 unplugin-vue-components 或 unplugin-element-plus 做按需加载，默认引入的是编译好的 dist/index.css，你的 SCSS 根本没参与构建。
样式入口文件顺序和命名空间冲突
项目里只能有一个统一的 Element Plus 主题入口，且它不能和其它样式逻辑混杂。
真正卡住人的往往不是变量怎么写，而是构建链路里某一层漏掉了 importStyle: 'sass'，或者以为改了 :root 就万事大吉，结果发现 el-date-picker 的弹层颜色还是旧的 —— 那是因为它的子组件用了独立的 CSS 变量，得单独覆盖。
