如何在Alembic离线模式下生成不含alembic_version表的迁移SQL？

当然支持！你可以通过调整Alembic的配置和命令，轻松生成不依赖alembic_version表的迁移SQL，完美适配你的外部版本跟踪工具。下面是具体步骤：

1. 修改Alembic环境配置文件（env.py） #

Alembic默认会在迁移过程中处理alembic_version表，我们需要在离线迁移的配置里禁用这个行为：

找到env.py中的run_migrations_offline函数，修改context.configure的参数，添加version_table=None（如果原本有version_table配置就直接替换）：

def run_migrations_offline() -> None:
    """Run migrations in 'offline' mode.

    This configures the context with just a URL
    and not an Engine, though an Engine is acceptable
    here as well.  By skipping the Engine creation
    we don't even need a DBAPI to be available.

    Calls to context.execute() here emit the given string to the
    script output.

    """
    url = config.get_main_option("sqlalchemy.url")
    context.configure(
        url=url,
        target_metadata=target_metadata,
        literal_binds=True,
        dialect_opts={"paramstyle": "named"},
        # 关键配置：禁用版本表
        version_table=None,
        version_table_schema=None  # 如果之前给版本表指定过schema，也设为None
    )

    with context.begin_transaction():
        context.run_migrations()

如果你的工作流偶尔也会用到在线迁移，建议同时修改run_migrations_online函数里的context.configure参数，同样添加version_table=None，避免在线模式下意外创建版本表。

2. 生成离线迁移SQL #

完成配置后，按照正常流程生成迁移脚本并导出SQL：

• 第一步，自动生成迁移脚本（如果需要）：

  alembic revision --autogenerate -m "描述你的迁移内容，比如add user table"
  

• 第二步，导出离线迁移SQL：

  alembic upgrade heads --sql > your_migration_file.sql
  

  此时生成的your_migration_file.sql里，只会包含你实际需要的表结构变更SQL，完全没有和alembic_version表相关的语句。

3. 额外注意事项 #

• 如果你手动编写迁移脚本，确保里面不要包含任何创建、更新或删除alembic_version表的操作；
• 因为没有了Alembic自带的版本跟踪，你需要完全依赖外部工具来管理迁移的执行顺序和已执行状态，避免重复执行或遗漏迁移。

内容的提问来源于stack exchange，提问作者Kiruahxh