ConfigProvider.theme仅影响CSS-in-JS生成的token样式，不覆盖antd.css静态类、手动CSS规则或静态方法（如message）样式，全局定制需结合CSS覆盖、css-in-js工具或构建时处理。
直接用 ConfigProvider 配 theme 对象是 Ant Design 5.x 官方推荐的「零运行时」主题定制方式，但很多人误以为它能覆盖所有 CSS 样式 —— 实际上它只影响通过 CSS-in-JS 注入的 token 衍生样式，对原始 class 名（如 .ant-btn）或未接入 token 的旧样式无效。
ConfigProvider.theme 只控制 token，不接管已有 CSS 类
Ant Design 5.x 的 theme 配置本质是向组件注入设计令牌（Design Token），比如 token.colorPrimary、token.borderRadius。这些 token 会被组件内部的 useStyle 或 genComponentStyleHook 转为内联样式或动态 CSS-in-JS 规则，但不会修改 antd/dist/antd.css 中已编译好的静态 class 行为。
- 如果你改了
theme.token.borderRadius，Button、Input、Card 等使用该 token 的组件圆角会变 —— 前提是它们没被你手动加 className 覆盖 - 但如果你写了
.ant-btn { border-radius: 0 !important; }，这个规则优先级更高，ConfigProvider无法覆盖 -
antd/dist/antd.css是构建时生成的完整样式表，不含任何 CSS 变量或 JS 运行时逻辑，和theme完全解耦
CSS 变量（CSS Custom Properties）不是 theme.token 的等价替代
Ant Design 5.x 默认不输出全局 CSS 变量（如 --ant-color-primary），它的 token 是 JS 对象，由 @ant-design/cssinjs 在运行时注入 style 标签。想用纯 CSS 变量覆盖，得自己定义并确保作用域正确：
- 在
:root或父容器上设置变量，例如：:root { --my-primary-color: #13c2c2; } - 然后在自定义 CSS 中引用：
.ant-btn { background-color: var(--my-primary-color); } - 注意：Ant Design 组件原生不读取这些变量，必须配合
className或style手动绑定，否则无效 - 别指望
ConfigProvider自动把token.colorPrimary同步成:root下的 CSS 变量 —— 它不做这事
想真正「全局覆盖」按钮、输入框等基础样式，得绕过 ConfigProvider
当业务要求强制统一视觉（比如所有按钮禁用圆角、所有边框改为虚线），仅靠 theme.token 不够，因为部分样式仍硬编码在组件实现里，或依赖默认算法生成。此时需组合手段：
立即学习“前端免费学习笔记（深入）”；
- 用
css-in-js工具（如antd-style）接管全部样式生成，支持从 token 映射到 CSS 变量 + 全局 class 注入 - 在项目入口 CSS 文件中写高优先级规则，例如：
.ant-btn, .ant-input, .ant-select-selector { border-radius: 0 !important; } - 用
@ant-design/static-style-extract提取静态样式后，再用 PostCSS 插件批量替换border-radius值（适合 CI 构建阶段） - 避免用
!important污染全局，可限定 scope：.my-app .ant-btn，并在根节点加className="my-app"
最易被忽略的一点：ConfigProvider 的 theme 对 message、Modal、notification 等静态方法完全无效 —— 它们脱离 React context 渲染，token 不会透传。真要定制这些弹层的样式，要么改用 Modal.useModal() 获取带上下文的实例，要么直接覆写其生成的 DOM class 规则。
