Python依赖管理工具

Python 项目依赖管理工具多样，核心在于理解各工具的设计理念与适用场景。

pip：基础包管理器

pip 是 Python 官方包管理器，通过 requirements.txt 管理依赖。

基本使用

# 安装包
pip install requests

# 安装指定版本
pip install requests==2.28.0

# 导出依赖
pip freeze > requirements.txt

# 从文件安装
pip install -r requirements.txt

依赖锁定策略

# requirements.txt
requests==2.28.0        # 精确版本锁定
flask>=2.0.0,<3.0.0     # 版本范围约束

pip 不自动创建虚拟环境，需配合 venv 使用。

pipenv：虚拟环境+依赖管理一体化

pipenv 整合虚拟环境管理与依赖管理，使用 Pipfile 替代 requirements.txt。

核心特性

# 安装包（自动创建虚拟环境）
pipenv install requests

# 安装开发依赖
pipenv install pytest --dev

# 生成 Pipfile 和 Pipfile.lock

Pipfile 结构

[packages]
requests = ">=2.28.0"

[dev-packages]
pytest = "*"

[requires]
python_version = "3.10"

Pipfile.lock 作用

• 锁定精确版本号
• 记录依赖树完整信息
• 确保团队环境一致性

Pipfile.lock 应提交到版本控制，保证团队成员环境一致。

poetry：现代依赖管理方案

poetry 提供完整的项目管理能力，包括依赖管理、构建、发布。

初始化项目

# 创建新项目
poetry new myproject

# 在现有项目中初始化
poetry init

依赖管理

# 添加依赖
poetry add requests

# 添加开发依赖
poetry add --group dev pytest

# 安装所有依赖
poetry install

pyproject.toml 结构

[tool.poetry.dependencies]
python = "^3.10"
requests = "^2.28.0"

[tool.poetry.group.dev.dependencies]
pytest = "^7.0.0"

核心优势

# 自动处理依赖冲突
poetry add flask  # 自动解析并更新兼容版本

# 构建与发布
poetry build
poetry publish

poetry 使用确定性算法解决依赖冲突，比 pip 更可靠。

工具对比

要点总结

1. pip：基础工具，适合简单项目，需配合 venv 手动管理环境
2. pipenv：适合需要环境隔离的项目，Pipfile.lock 确保一致性
3. poetry：现代化方案，适合需要完整项目生命周期管理的团队
4. 选择依据：项目规模、团队协作需求、是否需要发布包