用途 Nebula 项目结构参考用于在浏览代码库、运行命令或确定使用哪个包管理器时提供依据。它明确了项目目录的组织方式以及包管理器的检测方法。
目录结构 项目将实际工作代码与示例组件及 Workbench 页面规范分开:
src/ ├── components/ # 可用的组件实现及元数据 └── global.css # Canvas Workbench 加载的基础样式
pages/ # 实际使用的 Canvas Workbench 页面规范
examples/ ├── components/ # 可复制的示例组件(可能包含 mocks.json) └── pages/ # 仅供参照的示例页面规范
组件预览状态 组件预览状态以 src/components/<name>/mocks.json 的形式放在组件自身旁边,而不是放在集中的 stories 目录中。
配置来源 当 canvas.config.json 存在时,它是仓库路径的唯一依据。在该仓库中,它指向 Workbench 的以下内容:
componentDir: src/components
pagesDir: pages
globalCssPath: src/global.css
包管理器检测 通过检查项目根目录下的锁文件来检测包管理器:
package-lock.json → npm(npm run、npx)
yarn.lock → yarn(yarn、yarn dlx)
pnpm-lock.yaml → pnpm(pnpm、pnpm dlx)
bun.lockb → bun(bun run、bunx)
在上述操作说明中,所有命令都应使用检测到的包管理器。
适用场景 适用于在 Nebula 代码库中导航、运行命令,或需要判断项目使用哪个包管理器时。
限制 资料未提供除上述目录结构和包管理器检测以外的功能、收费、价格、平台、效果或使用步骤。