直接 import { Button } from 'antd' 会引入全部CSS，因其main字段指向全量CommonJS包，index.js内部统一导入所有组件样式；babel-plugin-import通过AST重写为import Button from 'antd/lib/button'并自动插入import 'antd/lib/button/style'实现按需加载。
为什么直接 import { Button } from 'antd' 会引入全部CSS
因为 antd 的默认导出（main 字段）指向的是 CommonJS 全量包，其 index.js 内部又统一引入了所有组件的样式入口（如 antd/lib/style/index.css）。即使你只用了 Button，Babel 和 Webpack 都无法在编译期剥离已执行的 require('./style') 调用——尤其当样式是通过副作用导入（side-effect import）时。Tree Shaking 对这类写法基本无效。
babel-plugin-import 是怎么解决样式的按需加载的
它不依赖运行时或打包工具的分析，而是在 AST 层面做两件事：import { Button } 被重写为 import Button from 'antd/lib/button'，同时**自动插入一行 import 'antd/lib/button/style'**（如果 style: true 开启）。关键点在于：这个新插入的样式路径是精确到组件粒度的，且仅出现在你真正使用该组件的文件中。
无序列表呈现核心行为：
-
style: true时，插件会查找libraryDirectory下同名子目录里的style文件（如antd/lib/button/style），若不存在则 fallback 到style/index - 若库使用 CSS-in-JS 或需要 Less 支持（如 antd v4），需额外配
style: (name) => `${name}/style/index.less` - 多个组件导入会被分别处理，不会合并成一条样式 import —— 每个组件的样式路径独立存在
配置 style 路径时最容易踩的三个坑
不同 UI 库的样式组织方式差异极大，硬套默认配置大概率失败：
立即学习“前端免费学习笔记（深入）”；
-
libraryDirectory: 'lib'对ant-design-v5有效，但对vant@4就得改成'es'，因为它的模块出口在es/目录下 -
element-ui的样式不在组件子目录里，而集中放在theme-chalk，必须用babel-plugin-component并配styleLibraryName: 'theme-chalk'，不能用babel-plugin-import的默认style逻辑 - 某些私有组件库把 CSS 放在
dist/css/xxx.css，此时style必须设为函数返回绝对路径，比如style: name => `dist/css/${name}.css`
如何验证 CSS 确实按需了
别只看打包体积数字——那可能是压缩或提取公共 chunk 带来的假象。真实验证方式只有两个：
- 打开最终构建产物（如
dist/js/app.xxx.js），搜索button/style、dialog/style这类字符串，确认只出现你实际使用的组件样式路径 - 在开发时临时注释掉某处
import { Dialog }，然后检查浏览器 Network 面板是否还加载了dialog/style.css对应的资源（注意 DevTools 的 “Disable cache” 要开启）
样式路径拼错或 style 配置未生效时，组件往往能渲染但完全没样式——这是最典型的静默失败，容易被忽略。
