Skip to content

代码生成器实战 ​

CLI 与后台共用生成逻辑,产物范围为后端 + Admin,不生成 PC/UniApp。完整首次生成流程见 第一个业务模块。

后台操作 ​

  1. 进入「开发工具 → 代码生成器」,按表名或注释搜索数据表。实体名只移除配置的 DB_PREFIX,不会把业务前缀 gen_ 或 biz_ 当作数据库前缀。
  2. 点击配置,填写独立模块名(如 demo、biz),核对模型名与 COMMENT,配置字段展示、筛选、控件及下拉选项。切换数据表会重置模型和模块配置,避免沿用上张表的名称。
  3. 预览全部产物,核对后生成。已有文件不会被默认覆盖,跳过和失败会分别显示;如需升级已有模块,使用 CLI 的增量更新流程。
  4. 结果窗口选择手动部署或 Docker,复制并完成菜单 SQL、reload、Admin build 三步;普通角色还要授权菜单及按钮。命令从项目根执行,菜单 SQL 首次导入前审核,勿重复导入。

APP_DEBUG=false 时可查看表和字段,但不能预览或生成。只在独立开发环境开启并重启,开发完成后恢复并重启。表/列 COMMENT 直接影响标签;疑似乱码会在生成前被阻止,先检查 utf8mb4 连接并修复原始注释。

CLI 与更新已有模块 ​

bash
cd server
php webman make:crud gen_articles --module=demo --model=GenArticle --preview
php webman make:crud gen_articles --module=demo --model=GenArticle --reload
# 模板或表结构变化后,先审阅三方合并计划
php webman make:crud gen_articles --module=demo --model=GenArticle --update --preview --json

--reload 不会导入菜单或编译前端。--update、--plan-token、--baseline-dir、保留名和覆盖规则详见 生成器完整选项。

常见现象 ​

现象检查项
生成成功但菜单不可见首次菜单 SQL 是否执行、角色是否授权、是否重新登录
菜单可见但页面不存在pnpm --dir admin build、菜单 component 与源码路径
API 404当前服务是否完成 reload,Docker 命令是否在容器内执行
中文标签乱码建表/修改 COMMENT 时的客户端连接编码,已生成文件还需更新
/admin/#/... 不生效使用 history 地址 /admin/demo/gen-article

Docker 完整命令见 Docker 生成后流程。

基于 MIT 许可发布