代码生成器实战
CLI 与后台共用生成逻辑,产物范围为后端 + Admin,不生成 PC/UniApp。完整首次生成流程见 第一个业务模块。
后台操作
- 进入「开发工具 → 代码生成器」,按表名或注释搜索数据表。实体名只移除配置的
DB_PREFIX,不会把业务前缀gen_或biz_当作数据库前缀。 - 点击配置,填写独立模块名(如
demo、biz),核对模型名与 COMMENT,配置字段展示、筛选、控件及下拉选项。切换数据表会重置模型和模块配置,避免沿用上张表的名称。 - 预览全部产物,核对后生成。已有文件不会被默认覆盖,跳过和失败会分别显示;如需升级已有模块,使用 CLI 的增量更新流程。
- 结果窗口选择手动部署或 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 生成后流程。