数据库迁移是用php代码描述表结构变更，通过up()和down()方法实现可重复、可回退、跨环境执行；必须新建迁移处理变更，禁止修改已执行文件；migrate按时间戳顺序执行并记录批次，rollback按批回退，fresh会清空重跑但生产禁用。
数据库迁移不是“把数据搬走”，而是用 PHP 代码描述表结构变更，并让这些变更可重复、可回退、可跨环境执行。
迁移文件本质是带 up() 和 down() 的 PHP 类
每个 database/migrations/xxx_create_users_table.php 文件就是一个迁移类，必须实现两个方法：
-
up()：定义“这次要怎么改结构”——建表、加字段、设索引、加外键 -
down()：定义“万一出错怎么撤回”——删表、删字段、删索引（建议统一用Schema::dropIfExists()而非Schema::drop()，避免表不存在时报错）
别手动改已执行过的迁移文件。哪怕只改了一个字段注释，也应新建迁移来修正，否则在其他环境执行时会因 checksum 或时间戳不一致失败。
php artisan migrate 不等于“运行所有 PHP 文件”
它实际做三件事：检查 migrations 表里哪些记录缺失 → 按文件名前缀（时间戳）排序 → 逐个执行 up() 并往 migrations 表插入记录。所以：
- 如果中途报错（比如字段长度超限），
migrations表可能只写入了部分记录，下次再跑migrate会跳过已记的，但卡住的那条不会自动重试 - MySQL 5.7.7 以下或 MariaDB 10.2.2 以下默认不支持
utf8mb4索引全长度，得在AppServiceProvider::boot()里加Schema::defaultStringLength(191) - 执行前确保
.env中DB_CONNECTION、DB_DATABASE等配置正确，且数据库已存在（Laravel 不自动创建库）
增删字段必须走新迁移，不能直接改旧文件
比如要给 users 表加 phone 字段，正确做法是：
- 运行
php artisan make:migration add_phone_to_users_table --table=users - 在新文件的
up()里写$table->string('phone')->nullable(); - 在
down()里写$table->dropColumn('phone'); - 再跑
php artisan migrate
常见错误是编辑已执行的迁移文件，在 up() 里追加字段——这会导致其他机器首次迁移时字段重复添加，或回滚时 down() 逻辑不匹配原始结构。
rollback 不是“撤销上一条 SQL”，而是按批回退
php artisan migrate:rollback 默认回退**最后一批**（batch）迁移，一批可能含多个文件（比如你一次跑了 3 个新迁移，它们共享同一个 batch ID）。所以：
- 想只退一个文件？用
--step=1，但前提是那个文件是该 batch 唯一成员 - 想彻底清空重来？
php artisan migrate:fresh会先删所有表（不含migrations表），再重跑全部迁移——注意：它不保留任何数据 - 生产环境禁用
:fresh和:reset，它们会无条件删除表
真正难处理的永远不是“怎么加字段”，而是“字段加完后，已有数据如何适配默认值或非空约束”——这部分没法靠迁移自动完成，得配合 DB::statement() 或单独写填充器。
