thinkphp迁移时字段注释丢失是因默认未启用注释支持：tp5.1需配置pdo参数并使用mysql驱动，tp6.x需继承正确基类且comment()必须紧跟addcolumn()调用。
ThinkPHP迁移时字段注释丢失的常见现象
直接用 php think migrate:run 执行迁移后，数据库表字段的 COMMENT 消失了——哪怕你在 create_table 的 addColumn() 里写了 comment('用户昵称')，最终建出来的字段也没注释。这不是 Bug，是 ThinkPHP 默认不把注释写入 SQL，底层 PDO 驱动压根没透传这个参数。
必须显式启用注释支持（5.1+ / 6.x 差异大）
ThinkPHP 5.1 和 6.x 对注释的支持机制完全不同，不区分版本直接抄配置会失效：
- 5.1 版本：需在数据库配置中加
'params' => [PDO::ATTR_EMULATE_PREPARES => true]，并确保使用mysql而非pdo_mysql驱动（否则注释被忽略） - 6.x 版本：默认支持注释，但必须用
Schema::table()+changeColumn()或建表时用addColumn('name', 'string', ['comment' => '用户名'])，且迁移类需继承think\migration\Migrate（不是think\migration\Base） - 无论哪个版本，
comment()必须紧跟在addColumn()后调用，不能链式写成addColumn()->comment()—— 这个调用无效
实操：一个能保留注释的迁移示例（TP6.x）
以下代码在 TP6.x 下可成功生成带注释的字段：
public function change(): void
{
$this->schema->create('user', function (Blueprint $table) {
$table->id();
$table->string('nickname', 50)->comment('用户昵称');
$table->integer('status')->default(1)->comment('状态：0禁用 1启用');
$table->timestamps();
});
}
注意三点：
-
comment()是Blueprint方法，不是ColumnDefinition的，所以只能在addColumn()级别调用 - MySQL 8.0+ 支持字段级注释；5.7 也支持，但部分旧版客户端（如某些 phpMyAdmin）可能不显示
- 执行完迁移后，用
SHOW FULL COLUMNS FROM user查看，确认Comment列有值，而不是靠 GUI 工具判断
同步已有表注释的补救方案
如果表已存在、字段没注释，又不想重跑迁移，可以用原生 SQL 补：
ALTER TABLE `user` MODIFY COLUMN `nickname` VARCHAR(50) COMMENT '用户昵称';
或者在迁移的 up() 中用 $this->execute() 手动执行：
- TP6.x：用
$this->execute("ALTER TABLE `user` MODIFY COLUMN `nickname` ...") - TP5.1：需先获取连接对象，再调用
query()，且 SQL 要适配当前数据库类型（如 SQLite 不支持COMMENT） - 别依赖模型的
$comment属性——那是给文档生成器用的，不影响数据库实际结构
注释这事看着小，但一旦漏掉，后续数据字典工具、DBA 审查、甚至某些 ORM 自动生成文档的功能就全断了。最稳妥的做法，是在建表迁移里一次性写全 comment，别指望后期补。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
