Pipenv 使用

Pipenv 是 Python 官方推荐的依赖管理工具，旨在简化 pip 和 virtualenv 的使用。其使用 Pipfile 和 Pipfile.lock 来管理项目的依赖和虚拟环境。

安装

pip install --user pipenv  # 如果当前用户不是 root，就使用 --user 选项

不要使用 brew 安装 pipenv:

Homebrew installation is discouraged because it works better to install pipenv using pip on macOS.

使用

pipenv install  # 为目录创建新的虚拟环境，并使用目录中的 Pipfile 或 requirements.txt 安装依赖
pipenv install --deploy  # deploy 会验证 Pipfile.lock 是不是由对应的 Pipfile 生成的

pipenv lock    # 生成 Pipfile.lock
pipenv sync    # 安装 Pipfile.lock 中的依赖
pipenv update  # 相当于 pipenv lock 和 pipenv sync

pipenv requirements > requirements.txt  # 生成 requirements.txt

可以设置 PIPENV_VENV_IN_PROJECT=1 环境变量来将虚拟环境安装在项目目录中。

换源

# 临时换源
pipenv install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy
# 永久换源
pipenv --pypi-mirror https://pypi.tuna.tsinghua.edu.cn/simple

使用虚拟环境

pipenv --venv              # 查看当前虚拟环境的信息
pipenv shell               # 激活虚拟环境
pipenv run python main.py  # 直接在外部运行虚拟环境命令
exit                       # 退出虚拟环境
pipenv --rm                # 删除虚拟环境

常用命令一览：

pipenv --where                 # 列出本地工程路径
pipenv --venv                  # 列出虚拟环境路径
pipenv --py                    # 列出虚拟环境的 Python 可执行文件
pipenv install                 # 创建虚拟环境
pipenv install [moduel]        # 安装包
pipenv install [moduel] --dev  # 安装包到开发环境
pipenv uninstall[module]       # 卸载包
pipenv uninstall --all         # 卸载所有包
pipenv graph                   # 查看包依赖
pipenv lock                    # 生成 lockfile
pipenv run python [pyfile]     # 运行 py 文件
pipenv --rm                    # 删除虚拟环境

参考：

• Pipenv 官网
• Python Guide CN
• Python——pipenv 精心整理教程 | 掘金
• 拥抱 pipenv - ThomasYoungK | 简书

Troubleshooting

Warning: the environment variable LANG is not set!

解决方案：Pipenv environment variable LANG is not set! | neldeles's personal blog/portfolio