Ant Design主题覆盖必须通过ConfigProvider传入theme对象，而非直接CSS覆盖；Next.js App Router中需确保Provider包裹全局、theme响应式更新且token命名准确，否则因SSR时机、CSS-in-JS缓存及动态class导致失效。
Ant Design 的主题覆盖不是简单地写几行 CSS 就能生效的，尤其在 Next.js（尤其是 App Router）中，样式作用域、SSR 注入时机、CSS-in-JS 缓存机制都会干扰你的自定义规则。直接覆盖 .ant-btn 类名往往失效，因为真实渲染的 class 是动态生成的（如 css-1a2b3c），且服务端注入的样式优先级更高。
为什么直接写 CSS 覆盖不了？
Next.js App Router 默认启用 CSS-in-JS（通过 @ant-design/cssinjs），所有组件样式由运行时 cache 提取并内联到 HTML 中。你写的全局 CSS 通常后加载、无足够 specificity、或未匹配到实际生成的 class 名，导致被忽略。
必须用 theme 配置对象（推荐方式）
Ant Design 5.x+ 官方只支持通过 theme 对象定制设计 token，这是唯一稳定、可 SSR、可主题切换的方式。硬覆盖 class 属于 hack，容易在升级后崩坏。
-
theme必须传给ConfigProvider，且该 Provider 需包裹整个应用（通常在app/layout.tsx或app/RootLayout中） - 不要在页面组件里局部传
theme，否则 SSR 时无效 - 所有 token 名必须严格使用 Ant Design 官方命名，比如
colorPrimary，不是primaryColor
示例（app/layout.tsx）：
className
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
