Python Pipenv 教程 #

什么是Pipenv？ #

Pipenv是Python官方推荐的现代依赖管理工具，它将pip和virtualenv的功能整合在一起，并添加了依赖锁定和环境管理功能。Pipenv解决了传统Python依赖管理中的许多痛点，如依赖冲突、版本锁定和环境隔离等问题。

Pipenv的主要优势 #

  • 自动管理虚拟环境：无需手动创建和激活虚拟环境
  • 依赖锁定：生成Pipfile.lock文件确保依赖版本的一致性
  • 依赖关系图：自动解析和可视化依赖关系
  • 安全检查：内置安全漏洞检测功能
  • 命令简化：统一的命令行接口简化工作流程

安装Pipenv #

使用pip安装 #

bash 
pip install --user pipenv

验证安装 #

bash 
pipenv --version

基本使用 #

创建新项目 #

在项目目录中初始化Pipenv：

bash 
cd your-project-directory
pipenv install

这将创建一个新的虚拟环境，并生成Pipfile文件。

安装依赖 #

安装生产依赖 #

bash 
pipenv install requests

安装开发依赖 #

bash 
pipenv install --dev pytest

激活虚拟环境 #

bash 
pipenv shell

运行Python脚本 #

无需激活虚拟环境即可运行脚本：

bash 
pipenv run python your-script.py

查看虚拟环境位置 #

bash 
pipenv --venv

查看Python解释器位置 #

bash 
pipenv --py

依赖管理 #

安装特定版本的包 #

bash 
pipenv install requests==2.25.1

更新依赖 #

bash 
pipenv update  # 更新所有依赖
pipenv update requests  # 更新特定依赖

移除依赖 #

bash 
pipenv uninstall requests
pipenv uninstall --dev pytest  # 移除开发依赖

查看已安装的依赖 #

bash 
pipenv graph  # 查看依赖关系图
pipenv lock --requirements  # 导出为requirements.txt格式

检查安全漏洞 #

bash 
pipenv check

Pipfile 和 Pipfile.lock #

Pipfile #

Pipfile是Pipenv的配置文件，包含了项目的依赖信息：

toml 
[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
requests = "==2.25.1"

[dev-packages]
pytest = "*"

[requires]
python_version = "3.9"

Pipfile.lock #

Pipfile.lock包含了所有依赖的精确版本和哈希值，确保在不同环境中安装相同的依赖版本：

json 
{
  "_meta": {
    "hash": {
      "sha256": "..."
    },
    "pipfile-spec": 6,
    "requires": {
      "python_version": "3.9"
    },
    "sources": [...]
  },
  "default": {
    "requests": {
      "hashes": [...],
      "index": "pypi",
      "version": "==2.25.1"
    }
  },
  "develop": {
    "pytest": {
      "hashes": [...],
      "index": "pypi",
      "version": "==6.2.4"
    }
  }
}

高级用法 #

从requirements.txt迁移 #

bash 
pipenv install -r requirements.txt

导出到requirements.txt #

bash 
pipenv lock --requirements > requirements.txt
pipenv lock --requirements --dev > requirements-dev.txt

自定义虚拟环境位置 #

在Pipfile中添加：

toml 
[scripts]
install = "pipenv install"

使用特定Python版本 #

bash 
pipenv --python 3.9
pipenv --python /usr/local/bin/python3.9

清理未使用的依赖 #

bash 
pipenv clean

检查依赖完整性 #

bash 
pipenv verify

最佳实践 #

  1. 始终提交Pipfile和Pipfile.lock：确保团队成员使用相同的依赖版本
  2. 使用开发依赖隔离：将测试、调试工具等放在dev-packages中
  3. 定期更新依赖：使用pipenv update保持依赖的安全性和最新性
  4. 使用特定Python版本：在Pipfile中指定Python版本以确保兼容性
  5. 运行安全检查：定期使用pipenv check检查依赖的安全漏洞
  6. 避免使用pip安装依赖：在Pipenv项目中始终使用pipenv install而不是pip install

常见问题 #

Pipenv与其他工具的比较 #

特性 Pipenv Virtualenv + pip Poetry
自动虚拟环境 ✅ ❌ ✅
依赖锁定 ✅ 部分（需手动） ✅
依赖图 ✅ ❌ ✅
安全检查 ✅ ❌ ❌
简单命令 ✅ ❌ ⚠️
官方推荐 ✅ ❌ ❌

如何解决依赖冲突？ #

  1. 使用pipenv graph查看依赖关系
  2. 尝试降级或升级冲突的依赖
  3. 使用pipenv install package==version指定兼容的版本
  4. 如果问题复杂，可以删除Pipfile.lock并重新生成

如何在CI/CD环境中使用Pipenv？ #

bash 
pipenv install --deploy  # 严格按照Pipfile.lock安装
pipenv run pytest  # 运行测试

总结 #

Pipenv是现代Python项目依赖管理的最佳选择，它简化了虚拟环境和依赖管理的工作流程，提高了项目的可维护性和一致性。通过本教程，您应该已经掌握了Pipenv的基本用法和最佳实践，可以开始在您的Python项目中使用Pipenv了。

相关资源 #

最后更新：2026-02-07