开发规范 ​

本文汇总 README 中的推荐做法与禁止事项，以及日常开发常用命令。写业务代码前扫一眼，能避免大部分架构踩坑。

推荐 vs 禁止 ​

更细的说明见：

• Grow 契约组件
• 命令式 API
• 局部覆盖组件库
• 业务模块开发

常用命令 ​

与根目录 package.json / README 一致：

仅操作 sample：

pnpm --filter grow-admin-sample dev
pnpm --filter grow-admin-sample build
pnpm --filter grow-admin-sample preview

业务模块依赖声明 ​

业务包 package.json 示例（与 README 一致）：

{
  "peerDependencies": {
    "vue": "~3.3.4",
    "@grow-admin-rock/components": "workspace:*"
  },
  "devDependencies": {
    "@grow-admin-rock/components": "workspace:*"
  }
}

业务模块不需要自行安装组件驱动，由宿主 installComponentDriver 完成。

宿主装配顺序（要点） ​

sample/src/plugin/initIoc.ts 中：

1. 先 installComponentDriver（定 UI 库、绑定 Message 等）
2. 再 .use() 各 Library（请求、状态、路由、业务模块…）
3. 最后 componentsLib（注册 Grow 组件，依赖驱动字典）
4. appContext.load() 后挂载 router

顺序错误会导致 Grow 组件找不到驱动映射。完整列表见 IOC 模块化。

84 个共有契约组件 ​

三个驱动包已对齐全部 84 个三库共有 Grow* 组件。切换 projectSetting.componentLibrary（并同步 vite preset）即可换 UI 库，页面里的 Grow 组件写法不用改。

不纳入契约层的能力 ​

以下属于参考项目或业务自行封装，不要放进 rock-components 契约层：

若业务需要类似能力，在 DesignCornerstone 业务模块中实现。

相关包速查 ​

更完整的 Rock 包列表见 DesignRock 核心层。