需安装匹配版本的think-migration扩展包并正确配置：一、按thinkphp版本选v1.x（tp5.0）、v2.x（tp5.1）或v3.x（tp6+）；二、确保在composer.json的require-dev中声明；三、在app/command.php中注册think\migration\command::class；四、部署时避免--no-dev参数跳过安装；五、检查cli模式下phar、mbstring等扩展是否启用。
如果您在ThinkPHP项目中执行php think migrate相关命令时提示“Command "migrate" is not defined”，则很可能是think-migration扩展包未正确安装或环境配置缺失。以下是安装ThinkPHP迁移工具包的具体步骤：
一、确认ThinkPHP版本并选择对应迁移包版本
think-migration扩展包与ThinkPHP主版本强耦合，错误的版本组合将导致命令不可用或运行报错。必须根据当前框架版本精确匹配迁移包版本。
1、在项目根目录执行composer show topthink/framework，确认ThinkPHP主版本号。
2、若为ThinkPHP 5.1，请安装topthink/think-migration v2.x版本，执行：composer require topthink/think-migration=2.0.*。
3、若为ThinkPHP 6.0及以上，请安装topthink/think-migration v3.x版本，执行：composer require --dev topthink/think-migration:^3.0。
4、若使用ThinkPHP 5.0，则需安装v1.x版本，执行：composer require topthink/think-migration:1.*。
二、检查并修正composer.json依赖声明位置
迁移命令属于开发期命令行工具，其类库必须被Composer识别为可加载的命令提供者，require-dev区声明是生产环境启用命令的前提条件。
1、打开项目根目录下的composer.json文件。
2、确认"require-dev"字段中已包含"topthink/think-migration": "^3.0"（TP6）或对应版本声明。
3、若仅写在"require"中，需剪切至"require-dev"区块内。
4、保存后执行composer update topthink/think-migration以确保依赖重载生效。
三、验证迁移命令是否注册到应用命令系统
即使扩展包已安装，若未在应用命令注册表中显式声明，框架仍无法识别migrate指令。该注册动作由app/command.php控制。
1、打开app/command.php文件。
2、确认其返回数组中包含迁移命令类引用：return [think\migration\Command::class];。
3、若文件不存在，请手动创建；若内容为空或返回空数组，请替换为上述标准写法。
4、若项目使用多模块结构，需确保该文件位于主应用目录（非子模块）下。
四、部署时禁用--no-dev参数
上线部署过程中若使用composer install --no-dev，会导致require-dev中声明的所有包（含think-migration）被跳过安装，迁移命令彻底消失。
1、在服务器部署脚本或CI/CD流程中，查找所有含--no-dev的composer install命令。
2、将其修改为composer install（开发与预发布环境）或composer install --no-dev仅用于无迁移需求的纯运行环境。
3、如确需精简生产环境依赖，可改用composer install --no-dev后，单独补装迁移包：composer require --dev topthink/think-migration。
4、执行php think list，观察输出中是否出现migration相关子命令（如migrate:create、migrate:run等）。
五、检查PHP CLI配置与扩展兼容性
迁移命令通过PHP CLI模式执行，其可用性受CLI专属php.ini配置影响，与Web服务器使用的php.ini可能不同。
1、执行php --ini，确认CLI加载的php.ini路径。
2、检查该php.ini中是否启用了phar和mbstring扩展（think-migration依赖二者）。
3、若使用Swoole环境，确认CLI下php -m | grep swoole有输出，避免因Swoole扩展冲突导致命令解析失败。
4、执行php think migrate:status，若返回“Migration table not found”，说明数据库连接正常但迁移表未初始化，可继续执行后续迁移操作。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
