pip install alembic 即可安装官方pypi最新稳定版1.19.1，自动依赖sqlalchemy（≥1.4）和可选python-dotenv，但不创建配置或初始化项目结构，仅提供命令行工具alembic。

pip install alembic 就够了，不需要额外参数或源指定，除非你明确遇到网络或镜像问题。

---

pip install alembic 会装什么

• 安装的是官方 PyPI 上的最新稳定版（当前是 1.19.1，2026年8月发布）
• 同时自动拉取依赖：主要是 SQLAlchemy（>=1.4）和 python-dotenv（可选，用于读取 .env）
• 不会自动创建配置、不初始化项目结构，只是把命令行工具 alembic 放进你的 PATH

---

安装后运行不了 alembic 命令？

常见原因和应对：

Pipeworx disify

检测一次性及临时邮箱地址 — 验证邮箱并检查域名是否属于已知的临时邮件服务

下载

• 虚拟环境没激活 → 检查是否执行了 source venv/bin/activate（Linux/macOS）或 venv\Scripts\activate（Windows）
• 安装到了系统 Python 而不是当前虚拟环境 → 运行 which alembic（macOS/Linux）或 where alembic（Windows），确认路径在你的 venv 里
• Windows 下提示“不是内部或外部命令” → 重启终端，或手动把 venv\Scripts 加进当前 shell 的 PATH
• 用 uv 管理依赖？→ 改用 uv add alembic，但行为一致，仍需后续 alembic init

---

需不需要指定版本或国内源？

一般不需要。但以下情况建议显式控制：

• 项目有兼容性要求（比如只支持 SQLAlchemy 2.0 以下）→ 用 pip install "alembic==1.13.0"
• 公司内网无法访问 PyPI → 加 -i @#@#@#@#@#@#@#@#@#@0
• CI/CD 流水线中追求确定性 → 在 requirements.txt 里写死版本，例如：alembic==1.19.1

---

安装本身很简单，真正容易卡住的地方是下一步：怎么让 alembic 找到你的数据库模型和 SQLAlchemy 引擎。那个环节出错，很多人误以为是安装失败。