直接修改 less 变量如 @primary-color 可行但需编译，must configure less-loader’s modifyvars correctly, ensure node_modules is not excluded, use correct options path and javascriptenabled: true, avoid invalid variable names or unsupported component-level vars.
直接改 @primary-color 这类 Less 变量是可行的，但必须走编译流程，否则变量根本不会生效——这不是 CSS 覆盖，而是预处理器层面的值替换。
less-loader 的 modifyVars 配置必须生效
很多人配了 modifyVars 却没效果，根本原因是 less-loader 没处理到 antd 的源码文件。默认 webpack 规则常 exclude node_modules，而 antd 的 Less 文件就在里面。
- 确保
rules中的test: /\.less$/没加exclude: /node_modules/ -
lessOptions位置要对：v7+ 的less-loader要写在options.lessOptions下；v5–v6 则直接写options.modifyVars -
javascriptEnabled: true必须保留，否则某些带 JS 表达式的变量（如颜色派生）会编译失败 - 变量名不加
@前缀：'primary-color'✅，'@primary-color'❌
哪些变量能覆盖，哪些不能？
Ant Design 官方文档列出的全局变量（如 primary-color、border-radius-base）基本都支持，但组件级变量（比如 btn-border-radius）不一定暴露为可覆盖项——它们可能被硬编码在组件自己的 Less 文件里，或已被 v5+ 的 CSS-in-JS 逻辑绕过。
- 优先查官方变量表：
@primary-color、@font-size-base、@link-color等通用变量稳定可用 - 避免试图覆盖
@menu-item-height这类未公开变量，容易失效或被后续版本移除 - v5 开始，部分样式已转为 CSS 变量（如
--ant-primary-color），此时 Less 覆盖无效，得用 runtime 方式注入
别把 Less 覆盖当成运行时主题切换方案
Less 变量只在构建时起作用。你改完 modifyVars 再 run npm run build，生成的是全新 CSS；想换主题就得重新打包，没法在用户点击按钮后实时切色。
- 需要运行时切换？别碰 Less，改用 CSS Variables +
ConfigProvider theme（v5.12+）或手动 setProperty - 多主题打包？可以配置多个
modifyVars对象，分别输出theme-light.css和theme-dark.css，再动态加载 - TS 类型提示缺失：Less 变量无类型约束，拼错名（如
'primay-color'）只会静默失败，建议用 IDE 的 Less 插件辅助补全
真正麻烦的不是怎么写 modifyVars，而是搞清当前项目用的是 v4/v5/v6、是否启用了 CSS-in-JS、以及哪些样式路径已被新机制接管——同一套变量，在不同版本里可能一个有效、一个彻底忽略。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
