自研组件库入口文件应语义化聚合而非简单转发：具名导出各组件类（如ybutton），默认导出含install方法的对象；组件文件只默认导出类，解耦可用性与可注册性；支持全量引入和按需引入，路径用相对路径，导出名与类名严格一致。
在自研组件库中，统一模块暴露的入口文件（如 index.js 或 components/index.js）是实现清晰 API、支持按需引入和全量注册的关键。核心不是“堆导出”，而是有策略地聚合与分层暴露。
用 index.js 做语义化聚合，而非简单转发
入口文件应作为用户感知的“第一界面”，导出内容需符合使用直觉：
- 具名导出每个独立组件类或函数，例如
export { YButton, YInput, YModal }—— 方便按需引入且保留 Tree-shaking 能力 - 默认导出一个可被
app.use()调用的安装对象（如YUI），内部封装批量注册逻辑，不暴露具体组件实例 - 避免在入口里写
export * from './button'这类模糊转发，它会掩盖真实导出结构，不利于类型推导和 IDE 提示
区分“可用”与“可注册”，暴露粒度要明确
组件类本身和它的安装行为应解耦：
- 每个组件文件（如
button/index.js）只默认导出一个类：export default class YButton { ... } - 该类可自带静态
install(app, name)方法，但不强制依赖框架；入口文件决定是否调用它 -
index.js不直接导出install函数，而是导出一个带install方法的对象：export default { install(app) { /* 遍历注册所有组件 */ } }
支持两种引入方式，入口保持兼容
用户可能选择全量引入或单组件引入，入口需同时满足：
- 全量使用：
import YUI from 'y-ui'; app.use(YUI);—— 依赖入口默认导出的install - 按需使用：
import { YButton } from 'y-ui'; app.component('YButton', YButton);—— 依赖具名导出，不触发任何副作用 - 若搭配自动导入插件（如
unplugin-vue-components），入口无需额外处理，插件会基于组件命名规则自动解析
避免常见陷阱：路径、循环与命名一致性
看似简单的入口文件，容易因细节影响整体体验：
- 所有子模块路径用相对路径（
./button），不要用别名（@/components/button），否则非 Vite/Webpack 环境下可能失效 - 入口文件内不要
import具体组件再导出，而应直接export { X } from './x'，减少执行时序依赖 - 组件名与导出名严格一致（如
export { YButton }对应class YButton），避免大小写或下划线混淆
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
