常见问题

构建相关

构建后 dist 里没有新组件？

Rollup 会扫描 packages/ 下含 index.js 的目录。确认 packages/{组件名}/index.js 存在且无语法错误。

组件目录名含缩写（如 gl、api），导出名不对？

Rollup 会根据目录名（kebab-case）自动转成 PascalCase，规则是「每段首字母大写」。对含缩写的情况可能不符合预期。

在 rollup.config.js 中通过 PASCAL_OVERRIDES 手动指定：

const PASCAL_OVERRIDES = {
  "baidu-map-gl": "BaiduMapGL",
  "some-api": "SomeAPI",
};

Demo 与文档

侧边栏没有新组件？

在 docs/.vitepress/config.js 的 sidebar["/components/"] 中添加链接。

Demo 不显示或报错？

• 确认 docs/demos/{组件名}-demo.vue 存在
• 确认 Demo 中 defineOptions({ name: "XxxDemo" }) 与文档中 component="XxxDemo" 完全一致