modifyVars 覆盖失效的首要原因是未启用 less-loader 的 javascriptEnabled: true；其次需确保主题文件正确 import 顺序、Webpack/Vite 配置范围合理，且 Ant Design 5 中需禁用 CSS-in-JS 才能生效。
modifyVars 覆盖后变量没生效？检查是否漏了 javascriptEnabled: true
Ant Design 的 Less 主题变量（如 @primary-color）大量依赖内联 JavaScript 表达式（比如颜色计算、条件判断），如果 less-loader 未启用 JS 支持，modifyVars 传入的变量会被忽略，或导致编译失败但无明确报错。这是最常被跳过的硬性前提。
-
less-loader@8+必须在lessOptions中显式设javascriptEnabled: true；less-loader@7及以下则用javascriptEnabled: true（旧写法），但已弃用 - 若使用 Vite，需确认
vite.config.ts中css.preprocessorOptions.less同样设置了该选项 - 不设此项时，
modifyVars仍会“接收”变量，但后续@import '~antd/es/style/themes/default.less'里的逻辑（如@link-color: color(~`colorPalette('@primary-color', 5)`)）直接报错或静默 fallback 到默认值
为什么 @primary-color 改了，按钮变色但表格边框没变？变量作用域不是全局的
Less 变量本身没有模块作用域，但 Ant Design 的样式组织是分层 import 的：default.less → components.less → 各组件 style/index.less。如果你只在入口 index.less 里用 modifyVars 覆盖，而某个组件（如 Table）的样式文件没有重新 @import 你覆盖后的变量上下文，它就仍用默认主题里的原始值。
- 确保你的自定义主题入口文件（如
theme.less）以正确顺序@import：先modifyVars覆盖，再@import '~antd/es/style/themes/default.less'，最后@import '~antd/es/style/index.less' - 避免在组件级
.less文件中重复声明同名变量（如又写一遍@primary-color: #ff6b35;），这会覆盖modifyVars的值且不可控 - Ant Design 4.x 使用的是 Less 3.x，变量覆盖是“最后一次声明生效”，顺序错误会导致意料外的结果
Webpack 中 modifyVars 不生效？确认 include 范围是否锁死了 antd
很多 Webpack 配置为了性能，给 less-loader 加了 include: /node_modules\/antd/，这会导致你项目目录下的 theme.less 根本不走 less-loader 的 modifyVars 流程——它只对 node_modules/antd 内的 Less 文件生效。
- 删掉
rules里针对less的include，或改用exclude排除非 antd 的路径 - 更稳妥的做法：把自定义主题文件放在
src/styles/theme.less，并在该文件中完整导入 antd 主题链，而非依赖 loader 的全局注入 - 验证方式：在
theme.less里加一行.test-var { color: @primary-color; }，看编译后 CSS 是否用了你设的值
升级到 Ant Design 5 后 modifyVars 完全失效？你可能正在混用 CSS-in-JS 主题
Ant Design 5 默认启用 CSS-in-JS（通过 ConfigProvider.theme），此时 Less 主题定制路径已成“兼容模式”。如果你同时配置了 modifyVars 和 ConfigProvider，后者优先级更高，前者会被绕过。
- 检查是否在根组件用了
<ConfigProvider theme={{ token: { colorPrimary: '#1677ff' } }}>—— 这会完全接管主题逻辑，Less 变量不再参与渲染 - 若坚持用 Less（例如需要服务端渲染或深度定制），必须禁用 CSS-in-JS：在
ConfigProvider中设置cssVar={false}，并确保未引入ant-design-vue/dist/reset.css或类似重置文件 - Ant Design 5 的
default.less已移除大部分 JS 计算，改用 CSS 变量，modifyVars能覆盖的变量大幅减少，重点转向token和components配置
modifyVars 就会变成一个安静的摆设。 
