ThinkPHP 的 think-migration 不自动建表，需手动执行 php think migrate:install 创建元数据表；迁移文件须置于 database/migrations/ 且命名规范；down() 必须与 up() 逆向操作，多环境需校验状态一致性。
Migration 表为什么没自动创建
ThinkPHP 的 think-migration 扩展不会在首次运行时自动建表，它默认依赖你手动执行初始化命令。如果你直接跑 php think migrate:status 却提示 Table 'think_migration' doesn't exist，说明迁移元数据表压根不存在。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确保已安装
topthink/think-migration并完成配置（config/migration.php存在且指定了table名，默认是think_migration） - 运行
php think migrate:install—— 这才是创建think_migration表的正确命令，不是migrate:run或其他 - 如果提示
Class 'Phinx\Console\Command\Init' not found，说明扩展未正确加载，检查composer.json中是否漏了"topthink/think-migration": "^3.0"并执行过composer install
执行 migrate:run 报错 “No migrations to run”
这个提示不一定是真没迁移文件，更常见的是路径或命名没对上。ThinkPHP 的迁移命令默认只扫描 database/migrations/ 下、文件名符合 YYYYMMDDHHIISS_*.php 格式（比如 20230101000000_create_user_table.php）的类。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认迁移文件放在
database/migrations/，不是app/database/或其他自定义路径 - 检查文件名是否含非法字符或空格；Windows 下容易因编码或隐藏字符导致解析失败
- 类名必须与文件名严格对应，且继承
think\migration\Migrator（不是 Phinx 原生的AbstractMigration） - 如果改过
config/migration.php里的path，记得清空runtime/cache/，否则旧路径缓存可能生效
rollback 回退后新增字段又丢了
ThinkPHP 迁移的 down() 方法默认只删表或删列，但如果你在 up() 里用了 $table->addColumn('xxx')，却在 down() 里忘了写 $table->dropColumn('xxx')，回退就会静默跳过，字段残留。更隐蔽的是：某些数据库（如 MySQL 5.7+）不支持 DROP COLUMN 在某些存储引擎下生效，会报错但不中断流程。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
down()不是可选的，必须和up()操作一一逆向，尤其增删列、改类型、加索引 - 避免在
up()里做数据填充（如Db::insert()），这类逻辑应放独立命令或种子（seeder），否则 rollback 无法还原数据状态 - 测试回退前，先用
php think migrate:status确认当前版本号，再php think migrate:rollback -t 20230101000000指定目标时间戳，别依赖默认步数
多环境迁移不同步导致部署失败
开发机跑了 migrate:run，测试环境却卡在旧版本，常见原因是 think_migration 表里的 version 字段被手动改过、或某次迁移中途失败后残留脏数据，导致后续命令拒绝执行。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上线前务必在目标环境执行
php think migrate:status，逐行核对status列是否全为up，有down就得先定位并修复 - 不要直接删
think_migration表重来，除非所有环境都重置；更安全的是用php think migrate:reset（需 ThinkPHP >= 6.1 + 扩展 v3.2+） - CI/CD 中建议加校验步骤：
php think migrate:status --format=json | jq -e 'all(.[] | .status == "up")'，非零退出即阻断发布
迁移的本质是让数据库结构变更可追溯、可重复。最容易被忽略的不是语法，而是每次 up() 和 down() 是否真正成对、是否在所有目标环境中验证过回退路径——尤其是加了唯一索引或外键之后，down() 很可能因为约束冲突而静默失败。
