pipenv使用教程

pipenv概述

pipenv 是一个强大的虚拟环境管理工具，它可以轻松的帮助我们在项目开发过程中创建和激活虚拟环境，和传统的virtualenv创建虚拟环境相比，pipenv实现了一体化。它的出现解决了旧的pip + virtualenv + requirements.txt的繁琐步骤实现了一行命令实现虚拟环境的部署。值得开心的是作为基于pip的python包管理工具，其语法与pip十分相似。

pipenv安装

 pip3 install pipenv  # 全局安装，如果只想在当前用户模式下安装，可添加参数：--user
 # 如需更新可使用
 pip3 install --user --upgrade pipenv
 ​
 注: 如果在使用当前用户模式下安装pipenv后在shell中提示不可用，则需要把用户库的目录“C:\Users\XXX\AppData\Roaming\Python\Python37\Scripts”添加到你的PATH【系统环境路径】中，然后重启电脑，环境变量生效后即可使用。

pipenv常用命令

1、pipenv --python版本， 在当前目录下初始化虚拟环境

 pipenv --two  # 使用当前系统中的Python2 创建环境
 pipenv --three  # 使用当前系统中的Python3 创建环境
 ​
 pipenv --python 3  # 指定使用Python3创建环境
 pipenv --python 3.6  # 指定使用Python3.6创建环境
 pipenv --python 2.7.14  # 指定使用Python2.7.14创建环境
 注意：
 1）创建环境时应使用系统中已经安装的、能够在环境变量中搜索到的Python 版本，否则会报错。
 2）每次创建环境都会在当前目录下生成一个名为Pipfile文件，用来记录刚创建的环境信息，如果当前目录下之前存在该文件，会将其覆盖。

1.1、修改依赖镜像，想要安装依赖包速度快点，可以修改Pipfile文件里面的源(直接修改url地址)，常见的国内python加速镜像源：

 http://mirrors.aliyun.com/pypi/simple/ //阿里
 https://pypi.tuna.tsinghua.edu.cn/simple/ //清华
 http://pypi.douban.com/ //豆瓣
 http://pypi.hustunique.com/ //华中理工大学
 http://pypi.sdutlinux.org/ //山东理工大学
 http://pypi.mirrors.ustc.edu.cn/ //中国科学技术大学

2、pipenv shell 启动当前目录下的虚拟环境，如果当前目录下无虚拟环境则会在当前目录下自动创建虚拟环境。启动了虚拟环境，执行python脚本才能正确找到依赖模块

 aiden@**** pipenv_01 % pipenv shell
 Launching subshell in virtual environment...
  . /Users/aiden/.local/share/virtualenvs/pipenv_01-IEV0TcCW/bin/activate
 aiden@**** pipenv_01 %  . /Users/aiden/.local/share/virtualenvs/pipenv_01-IEV0TcCW/bin/activate
 (pipenv_01) aiden@**** pipenv_01 % 
 # 注：环境经激活后，会发现命令提示符变了：（下图中的“pipenv_01”前缀，表示生成了名为“pipenv_01-IEV0TcCW”的虚拟环境
 ​
 # 执行python脚本
 (pipenv_01) aiden@**** pipenv_01 % python3.8 panda_study/demo.py 

3、安装或卸载依赖模块到虚拟环境中

 pipenv install XXX  # 安装XXX模块并加入到Pipfile
 pipenv install XXX==1.11  # 安装固定版本的XXX模块并加入到Pipfile
 pipenv install pytest --dev # 仅仅安装开发环境下的依赖包（项目部署上线不需要的包）
 ​
 pipenv uninstall XXX  # 卸载XXX模块并从Pipfile中移除
 pipenv uninstall --all  # 卸载全部包并从Pipfile中移除
 pipenv uninstall --all-dev  # 卸载全部开发包并从Pipfile中移除

4、pipenv graph 查看当前虚拟环境下的所有依赖，在虚拟环境中安装了pandas和requests两个库：

 aiden@**** pipenv_01 % pipenv graph
 pandas==1.2.5
   - numpy [required: >=1.16.5, installed: 1.21.0]
   - python-dateutil [required: >=2.7.3, installed: 2.8.1]
     - six [required: >=1.5, installed: 1.16.0]
   - pytz [required: >=2017.3, installed: 2021.1]
 requests==2.25.1
   - certifi [required: >=2017.4.17, installed: 2021.5.30]
   - chardet [required: >=3.0.2,<5, installed: 4.0.0]
   - idna [required: >=2.5,<3, installed: 2.10]
   - urllib3 [required: >=1.21.1,<1.27, installed: 1.26.5]

5、pipenv --venv 查看当前虚拟环境的安装路径

 aiden@**** pipenv_01 % pipenv --venv
 /Users/aiden/.local/share/virtualenvs/pipenv_01-IEV0TcCW

6、exit 退出当前虚拟环境，命令行提示符前缀消失：

 (pipenv_01) aiden@**** pipenv_01 % exit
 Saving session...
 ...copying shared history...
 ...saving history...truncating history files...
 ...completed.
 Deleting expired sessions...      24 completed.
 aiden@**** pipenv_01 % 

7、pipenv update * 升级部分包或依赖

 pipenv update --outdated  # 查看所有需要更新的依赖项
 pipenv update  # 更新所有包的依赖项
 pipenv update <包名>  # 更新指定的包的依赖项

8、pipenv run python test.py 不激活虚拟环境下使用虚拟环境中的解释器执行 python 程序

 aiden@**** pipenv_01 % pipenv run python3.8 panda_study/demo.py  # 正确导入了模块，脚本没有报错

9、requirements文件兼容，pipenv可以像virtualenv一样用命令生成requirements文件：

 pipenv lock -r > requirements.txt  # 将Pipfile和Pipfile.lock文件里面的包导出为requirements.txt文件
 pipenv lock -r --dev > requirements.txt  # 将Pipfile和Pipfile.lock文件里面的开发包导出为requirements.txt文件

10、pipenv通过requirements文件安装模块：

 pipenv install -r requirements.txt
 pipenv install -r --dev requirements.txt  # 只安装开发包

pipenv项目部署

 git clone project.git
 ​
 cd project
 ​
 pip3 install pipenv
 ​
 pipenv shell
 ​
 pipenv sync # 如果要安装跟Pipfile.lock版本一致的包，则执行pipenv sync; 
 pipenv install # 如果不需要与Pipfile.lock版本一致，则执行pipenv install即可
 ​
 pipenv run python main.py