1. 核心理念

Ulthon Admin 引入了 Scheme 层（位于 app/admin/scheme/），作为数据库结构的“代码化真理”。
生成 CURD 代码时，系统会强制检查 数据库实际结构 与 Scheme 代码定义 是否完全一致。如果不一致，为了防止代码逻辑与数据库脱节，CURD 生成将被拒绝。

2. 常见报错与解决

报错：CURD 生成已拒绝：数据库结构与 Scheme 不一致

当你看到类似如下报错时：

CURD 生成已拒绝：数据库结构与 Scheme 不一致（ul_test_goods）
字段类型不一致：id DB=int unsigned Scheme=int
字段注释不一致：title DB=标题 Scheme=标题1

原因：

• 你手动修改了数据库（如 Navicat 改了字段），但没有更新 Scheme 文件。
• 或者你手动修改了 Scheme 文件，但没有同步到数据库。

解决方法：

场景 A：我修改了数据库，想同步到 Scheme（推荐）

如果你习惯使用数据库工具设计表结构，请在修改完成后执行：

# 读取数据库结构，覆盖/生成对应的 Scheme 文件
php think scheme:make -t {table_name}
# 示例
php think scheme:make -t test_goods

场景 B：我修改了 Scheme 代码，想同步到数据库

如果你习惯直接写 PHP 代码定义表结构，请在修改完成后执行：

# 将 Scheme 代码的变更应用到数据库（会自动备份原表）
php think scheme:sync

3. 标准开发流程

第一步：设计表结构

推荐使用数据库管理工具（如 Navicat）创建或修改表结构。确保字段类型、注释、索引都设置正确。
注意：字段注释中可以定义组件类型，格式为 注释内容 {组件类型} (选项1:值1, 选项2:值2)。

第二步：生成/更新 Scheme

执行命令，将数据库变动固化为代码：

php think scheme:make -t test_goods

此时系统会自动处理字段类型兼容性（如忽略 int(11) 的显示宽度）和注释格式化。

第三步：生成 CURD

确保第二步无误后，执行：

php think curd -t test_goods

此时系统会校验通过，并生成控制器、模型、视图和 JS 文件。

4. 高级技巧

组件定义语法

在数据库字段注释中，可以使用特定语法直接定义前端组件：

• 格式：字段含义 {组件类型} (key:value, ...)
• 示例：
  • 状态 {select} (1:正常, 0:禁用) -> 生成下拉框
  • 头像 {image} -> 生成单图上传
  • 内容 {editor} -> 生成富文本编辑器

强制覆盖

如果生成的 CURD 代码不满意，可以随时重新生成（会覆盖 app/ 下的对应文件，请谨慎）：

php think curd -t test_goods -f

临时预览

不确定生成效果时，可以生成到临时目录查看：

php think curd -t test_goods -r

文件将生成在 runtime/source/ 目录下。