根本原因是Less编译链断裂：@primary-color必须在antd.less加载前被解析注入，否则样式已按默认值编译完毕；正确顺序是先导入default.less，再重定义变量，最后导入antd.less，并确保入口文件顶部引入且禁用antd.css。
@primary-color 改了还是蓝色，不是变量写错了，是 Less 编译链断了——变量必须在 antd.less 加载前被解析注入，否则所有样式早已按默认值编译完毕。
为什么直接改变量不生效？
根本原因在于 Ant Design 的 Less 构建顺序不可逆：default.less → 组件变量计算 → antd.less。你后写的 @primary-color: #ff6b35; 如果出现在 antd.less 之后，或被 import 'antd/dist/antd.css' 提前加载的静态 CSS 覆盖，就完全无效。
- 在组件级
Button.module.less里重定义@primary-color：作用域仅限当前文件，不影响全局主题构建 - 在
import 'antd/dist/antd.css'之后再import './theme.less'：CSS 已静态生成，变量覆盖无意义 - 用 CRA 却没配
craco-less或lessOptions.modifyVars：Webpack 根本没把你的变量传给less-loader -
@import '~antd/lib/style/themes/default.less'路径拼错（比如少个/）：导入失败，后续所有变量声明全跳过
theme.less 的正确加载顺序
只有一条链路能保证变量生效：基底变量 → 重定义 → 组件样式。新建 src/theme.less，内容严格按此顺序：
@import '~antd/lib/style/themes/default.less'; @primary-color: #ff6b35; @border-radius-base: 6px; @font-size-base: 14px; @import '~antd/dist/antd.less';
并在 src/index.tsx 最顶部（任何其他 import 之前）写：
立即学习“前端免费学习笔记（深入）”；
import './theme.less';
同时删掉项目中所有 import 'antd/dist/antd.css'——它和 Less 编译冲突，留着必失效。
Webpack/Vite 中 modifyVars 不生效怎么办？
modifyVars 不是万能开关，它依赖 javascriptEnabled: true 才能解析 Ant Design 里大量使用的 JS 表达式（比如 color(~`colorPalette('@primary-color', 5)`)），否则静默 fallback 到默认值。
-
less-loader@8+必须在lessOptions中显式设javascriptEnabled: true - Vite 用户检查
vite.config.ts中css.preprocessorOptions.less是否同样设置了该选项 - Webpack 配置里若写了
include: /node_modules\/antd/，会导致你项目目录下的theme.less根本不走less-loader的modifyVars流程——删掉或改用exclude - 更稳妥做法：把自定义主题文件放在
src/styles/theme.less，并在该文件中完整导入 antd 主题链，而非依赖 loader 的全局注入
用了 ConfigProvider 还是被样式覆盖？
Ant Design 5.x 的 CSS-in-JS 默认用 :where() 降低选择器权重来兼容旧项目，这也让自定义样式更容易被更高特异性的规则覆盖。比如你在全局 CSS 里写 .ant-btn { color: red; }，可能被 :where(.ant-btn):hover 的权重压制。
- 别靠
!important强顶——它会破坏 token 派生逻辑，且无法响应动态主题切换 - 优先用
ConfigProvider的theme.token覆盖 Seed Token（如colorPrimary），再配合algorithm触发派生计算 - 组件级定制用
componentToken（如Button: { colorPrimary: '#ff6b35' }），避免污染全局 - 注意：静态方法如
message.success()、Modal.confirm()不继承ConfigProvider的 theme，需用App包裹或useModal显式传入 contextHolder
最易忽略的一点：v6 的 zeroRuntime 模式下，modifyVars 和传统 Less 覆盖完全失效，必须迁移到 ConfigProvider.theme + Design Token 体系；而 v5.8+ 的组件 token 若未显式传 algorithm，则不会基于新 colorPrimary 重新计算 hover、active 等状态色——这些细节不查文档几乎必然踩坑。
