doctrine migrations生成的php迁移文件（如version20260310190500.php）默认存放在migrations/目录下，路径由config/packages/doctrine_migrations.yaml中dir_name配置决定，首次运行doctrine:migrations:diff时若目录不存在会自动创建。
迁移文件默认存放在 migrations/ 目录下
Doctrine Migrations 生成的 PHP 迁移类文件（如 Version20260310190500.php）默认写入项目根目录下的 migrations/ 子目录。这个路径不是硬编码在框架里，而是由 doctrine_migrations.yaml 配置决定的。
如果你没改过配置，它就在这里；但一旦项目升级或手动调整过迁移配置，位置可能不同。别凭经验盲找，直接看配置：
-
config/packages/doctrine_migrations.yaml中的dir_name项指明了实际路径，例如：dir_name: '%kernel.project_dir%/migrations' - 多数据库场景下，每个 EntityManager 可能有独立的
dir_name，需配合--em=xxx参数使用对应目录 - 如果
migrations/目录不存在，doctrine:migrations:diff第一次运行时会自动创建
为什么有时 migrations/ 目录里什么都没有？
常见原因不是路径错了，而是命令没触发生成——本质是 Doctrine 没检测到结构差异。
-
doctrine:migrations:diff不会生成空迁移：如果实体和数据库当前结构完全一致，它就静默退出，不建文件 - 实体类缺少
@ORM\Entity或字段没加@ORM\Column，会导致映射未被识别，diff 认为“无变更” - 用了过时的
doctrine:generate:entities（Symfony 5.4+ 已弃用），可能破坏了元数据缓存，导致 diff 失效 - 数据库连接指向了空库或错误库（比如连到了测试库但你在改开发实体），diff 对比的是“那个库”，不是你想象的库
make:migration 和 doctrine:migrations:diff 生成的文件位置一样吗？
一样，都落到 dir_name 配置的路径下。但行为逻辑不同，容易混淆：
-
make:migration是 Maker Bundle 提供的快捷命令，底层调用的就是doctrine:migrations:diff，只是加了交互提示和默认命名优化 - 两者都依赖 Doctrine 的 Schema Comparator，所以对同一组实体+数据库状态，生成的迁移内容几乎一致
- 区别在于：如果项目里同时启用了多个 Maker Bundle（比如自定义了迁移生成器），
make:migration可能注入额外逻辑；而doctrine:migrations:diff更“原生”，适合 CI 或脚本化调用
生产环境迁移文件不能删、不能手动改
迁移文件不是临时脚本，是版本控制链的一环。误操作会直接破坏团队协作和回滚能力。
- 已执行过的迁移文件绝不能删除：数据库里的
doctrine_migration_versions表只记录“哪个版本执行过”，不校验文件是否存在；删了文件再跑migrate会报错“version not found” - 不要手动编辑已提交的迁移文件：哪怕只是改个注释，也会导致 Git 冲突、SHA 校验失败（Doctrine 8.1+ 默认开启 checksum 验证）
- 如果发现刚生成的迁移有误（比如漏字段），正确做法是：立刻
git restore回退该文件 → 改实体 → 再doctrine:migrations:diff生成新版本，而不是修旧文件
Version*.php，往往要花半小时排查，而不是花两分钟重生成。
