thinkphp 6 默认不带 migrate 命令，需安装 topthink/think-migration 扩展、在 config/console.php 中注册命令类、执行 php think migrate:install 初始化状态表，三者缺一不可。
ThinkPHP 6 默认不带 migrate 命令，必须手动安装扩展、注册命令类、初始化状态表，三者缺一不可；否则 php think migrate:run 会静默失败或报 “Command not defined”。
迁移命令不存在？先确认 topthink/think-migration 是否装对了
TP6 不内置迁移功能，topthink/think-migration 是独立扩展包，版本和安装方式极易出错：
- TP6.0.8 及以上或 TP6.1+ 必须用
composer require topthink/think-migration:^3.0；旧版 TP6.0.0–6.0.7 只能用^2.0 - 上线部署时若用了
composer install --no-dev，而该包被写在require-dev里，命令会直接消失——它只在命令行生效，生产环境也得留着 - 装完后必须运行
php think list，确认输出里有migrate:install、migrate:run等条目；没有就说明类没注册或自动加载失败 - 检查
composer.json中是否真有"topthink/think-migration": "^3.0"（注意不是think-migrations或topthink/think-phinx）
config/console.php 必须显式注册迁移命令类
即使扩展已安装，命令未注册仍无法识别子命令：
- 打开
config/console.php，确保'commands'数组中包含'\think\migration\Command::class' - 老项目（如 TP6.0.0–6.0.7）若无
commands键，需手动添加该配置项 - 极少数环境未自动加载，可在
app/command.php中返回数组并追加该类路径：return [\think\migration\Command::class]; - 执行
php think list验证，若仍无migrate:相关命令，说明注册失败或框架版本存在兼容 bug（建议升至 TP6.0.8+）
php think migrate:install 报 Class 'PhinxConsoleCommandInit' not found
这不是 Phinx 配置问题，而是 topthink/think-migration 根本没被 Composer 正确加载：
- 执行
composer dump-autoload -o强制刷新自动加载映射 - 确认
vendor/autoload.php在入口文件（如think）中被引入 - 某些定制化项目禁用了 Composer autoload，需手动检查加载逻辑
- 临时加一行
var_dump(class_exists('\Phinx\Console\Command\Init'));验证 Phinx 类是否可访问
“No migrations to run” 却明明有文件？路径与命名必须严丝合缝
迁移命令只扫描特定路径下符合严格命名格式的 PHP 文件，路径或命名错误将导致误报：
- 迁移文件必须放在
database/migrations/（注意拼写是migrations，非migrateions或migration） - 文件名必须以 14 位时间戳开头，例如
20230101000000_create_user_table.php；禁止使用v1、_init等非时间戳前缀 - Linux 和 Windows 下因
scandir()排序差异可能导致加载顺序错乱，建议统一用 Git 提交并避免手动重命名 - 文件内类名无需与文件名一致，但必须继承
\think\migration\Migrator，且命名空间为默认（TP6）或Database\Migrations\（TP8）
最常被忽略的是：迁移状态依赖数据库中的 think_migration 表，这个表一旦损坏或不同步，后续所有操作都会失准；初始化之后别删它，也别手动改它的 batch 或 version 字段。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
