ThinkPHP迁移工具导出数据为空是因为migrate:export仅导出已执行迁移对应的表结构（CREATE TABLE），不导出实际数据；手动创建的表若未定义在迁移文件中则被跳过，需用db:backup或mysqldump导出真实数据。
ThinkPHP迁移工具导出数据时表结构正常但数据为空
不是迁移工具没跑完，大概率是 php think migrate:export 默认只导出「已执行成功」的迁移记录对应的数据表，而你手动创建或后期新增的表根本不在迁移历史里，自然被跳过。
实操建议：
- 先运行
php think migrate:status，确认目标表是否出现在列表中且状态为Ran - 如果表不在列表里，说明它没被任何
create_xxx_table.php迁移文件定义过——迁移工具根本不认它 - 临时补救：用
php think db:backup（需开启数据库备份命令）或直接 mysqldump 导出全库，别依赖迁移导出 - 长期解法：为该表补写一个迁移文件（哪怕只是空的
up()），再执行php think migrate:refresh --seed触发重载
导出 SQL 文件里没有 INSERT 语句，只有 CREATE TABLE
ThinkPHP 的 migrate:export 本质是把迁移类里的 up() 方法生成的 DDL（建表语句）打包，它不读数据库、不查数据，天生就不负责导出已有记录。
常见错误现象：看到导出文件里一堆 CREATE TABLE，以为“导出完成”，结果新环境一跑迁移，表是空的。
立即学习“PHP免费学习笔记（深入）”；
使用场景要分清：
-
migrate:export→ 仅用于版本化「表结构变更逻辑」，适合团队协作中追踪 DDL 演进 - 导出真实数据 → 必须用
db:backup、mysqldump或自定义导出脚本 - 想让迁移自动带数据？得自己在迁移类的
up()里手写$this->insert()，但仅适用于固定初始化数据（如配置项、枚举值）
执行 php think migrate:export 报错 Class 'xxx' not found
这是典型的自动加载失败，根源在于迁移类文件命名或命名空间和实际路径不一致。ThinkPHP 要求迁移类必须严格遵循 database/migrations/2024_01_01_000000_create_users_table.php 这种格式，且类名必须是 CreateUsersTable，命名空间固定为 app\database\migrations（或你配置的 database.migration_namespace）。
容易踩的坑：
- 文件名里用了大写字母或下划线以外的符号（比如
create-user-table.php），类就不会被扫描到 - 类文件里写了
namespace app\database\migrations\v2，但配置里没改database.migration_namespace - 用 IDE 重命名了类，但忘了同步改文件名，导致 PSR-4 加载失败
- 缓存没清：改完后记得运行
php think clear:all，否则旧的类映射还在
从旧项目迁移时，新环境执行 php think migrate 报错 Duplicate column name
这不是导出问题，是迁移执行顺序错乱导致的典型冲突。ThinkPHP 按文件名前缀（时间戳）排序执行迁移，如果你从旧项目拷贝了部分迁移文件过来，又在新项目里新建了同名时间戳的文件，或者手动改过文件名，就会触发重复建字段。
关键判断点：
- 看报错里的
Duplicate column name 'xxx'，立刻去对应迁移类的up()方法里找$table->addColumn('xxx')—— 它很可能已在更早的迁移里加过了 - 检查
migration表（默认表名）内容，确认哪些迁移已被标记为Ran，再比对本地文件是否多出了“重复建字段”的迁移 - 不要直接删迁移文件！应修改对应类的
up()，加上字段存在判断：if (!$schema->hasColumn('xxx')) { ... } - 如果只是开发环境，可临时清空
migration表 + 删除所有迁移记录，再重新跑，但生产环境严禁这么干
迁移不是万能的数据搬运工，它管结构演进，不管存量数据快照。真要保数据，备份和还原永远比迁移导出靠谱。
