删迁移文件会出问题，因Buffalo依赖14位时间戳前缀排序且不校验内容完整性；删除中间文件将导致后续迁移被跳过或误触发回滚。

不能直接删迁移文件，否则 soda migrate 会静默跳过后续文件或执行顺序错乱。 Buffalo 的迁移系统完全依赖时间戳前缀排序，且不校验文件内容完整性——删掉中间某个 .up.fizz，后面所有文件都会被忽略，甚至可能误执行 .down.fizz 回滚逻辑。

为什么删迁移文件会出问题

Buffalo 使用 soda migrate 扫描 models/migrations/ 目录时，只按文件名开头的 14 位时间戳（如 20260928152233）升序排序。它不会解析文件内容、不检查是否已执行、也不记录“已废弃”。一旦你手动删除一个文件：

• 后续更高时间戳的迁移不会自动前移补位，而是被跳过
• 如果残留了对应 .down.fizz 但没了 .up.fizz，soda migrate down 可能触发意料外的回滚
• 开发环境反复 buffalo dev 启动时，buffalo db migrate 会静默跳过缺失文件，不报错也不提示

真正安全的清理方式：用 soda migrate down + 手动删文件

必须先确保该迁移尚未在目标环境（如 development）中执行过；若已执行，得先回滚再删：

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 查当前已执行的迁移：soda migrate status -e development
• 若目标迁移（如 20260928152233_add_status_to_users.up.fizz）状态为 applied，先回滚：soda migrate down -e development -n 1（或指定具体时间戳）
• 确认已回滚后，再删掉对应的 .up.fizz 和 .down.fizz 文件
• 删完立刻运行 soda migrate status -e development 验证是否清空

哪些文件可以放心删？

只有同时满足以下全部条件的迁移文件才可删除：

• 从未在任何环境（development/test）中执行过（soda migrate status 查不到）
• 没有其他迁移文件通过 t.ForeignKey() 或 SQL 引用它的字段或表
• 本地 Git 分支未推送，或团队已同步知晓该文件作废（避免别人 pull 后执行失败）
• 文件名时间戳不是“最小”或“最大”的——删掉边界文件更容易引发排序偏移

最常被忽略的一点：即使你只是临时生成了一个测试迁移，只要它被 soda migrate up 执行过一次，就必须走 down 流程才能清理。时间戳不是“版本号”，它是迁移系统的唯一调度键——动它，等于动整个执行链路的时序基础。