改 prefixcls 必须同步修改 js 运行时配置和 css 编译时的 @ant-prefix 变量，否则 js 生成的类名与 css 规则不匹配导致样式丢失；configprovider 的 theme 中 prefixcls 无效。
为什么改 prefixCls 不能只动 JS 配置？
改 prefixCls 是解决样式冲突的常用手段，但只在 JS 层调用 ConfigProvider 或 app.use(Antd, { prefixCls: 'xxx' }) 是不够的。因为 antd 的 CSS 文件（如 antd.css）里写的类名仍以 ant- 开头，JS 生成的 className 和实际加载的 CSS 规则对不上，必然漏样式。
必须同步处理两处：
- JS 运行时：通过
ConfigProvider或全局app.use设置prefixCls - CSS 编译时：让 LESS 变量
@ant-prefix也指向同一前缀，否则打包出来的 CSS 类名还是ant-btn这类
Umi 项目中如何正确覆盖 @ant-prefix？
Umi 默认支持主题变量注入，但配置位置和写法容易出错。不是所有 config.ts 写法都生效，尤其当用了 antd: { config } 时，它只影响 JS 层 prefixCls，不触碰 CSS。
正确做法是双管齐下：
- 在
config/theme.ts（或config.ts的theme字段）中设置：'@ant-prefix': 'my-ant' - 同时在
config.ts的antd配置里补上：config: { prefixCls: 'my-ant' } - 确保没有同时引入
antd/dist/antd.css—— 它硬编码了ant-，应改用按需加载或@ant-design/static-style-extract生成定制样式
Vue 项目用 ant-design-vue 怎么避免重复 patch？
Vue 生态里常见错误是：既在 main.ts 调用 app.use(Antd, { prefixCls: 'v2-' })，又在组件内部手动传 prefixCls prop。后者会覆盖前者，导致部分组件前缀不一致。
可靠做法只有这一种：
- 全局注册时统一指定：
app.use(Antd, { prefixCls: 'v2-' }) - 彻底删除所有组件上的
prefixCls属性（包括<button prefixcls="v2-"></button>这类） - 确认
ant-design-vue/dist/antd.css没被直接 import —— 否则它的.ant-btn会和你 JS 生成的.v2-btn完全不匹配
ConfigProvider 的 theme 配置对 prefixCls 无效？
从 antd 5.0 开始，theme 属性用于 design token 主题定制（颜色、圆角、间距等），它**不接管类名前缀逻辑**。哪怕你写了 <configprovider theme="{{" cssvar: true prefixcls:></configprovider>，其中 prefixCls 字段会被忽略。
真正生效的只有两个入口：
- 全局初始化时的
prefixCls选项（app.use或createRoot传参） - LESS 编译期的
@ant-prefix变量（必须走 less-loader 或 umi theme 配置）
别指望 theme 能一揽子解决命名空间问题 —— 它的设计目标本来就不包含这个。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
