pip工具

从python3.4版本开始,pip工具默认包含在了python的安装包中

python Packagings文档
pip官方文档

常用命令

pip命令执行的方式有如下两种:

  • pip <args>
  • pyhton -m pip <args>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
pip install somePackage             # 安装最新版本
pip install somePackage==1.0.4 # 安装指定版本,如果之前有安装其他版本,会先卸载老的版本
pip install 'somePackage>=1.0.4' # 安装指定最低版本
pip freeze > requirements.txt
pip install -r requirements.txt # 根据requirements文件安装
pip install --upgrade somePackage # 升级软件到最新版本

pip install /path/to/SomePackage-1.0-py2.py3-none-any.whl # 安装本地指定文件

pip wheel --wheel-dir=. requests # 下载requests及依赖包到wheel-dir目录,不安装
pip wheel --wheel-dir=/local/wheels -r requirements.txt
pip install --no-index --find-links=. requests # 在本地find-links指定的目录查找包进行安装
pip install --no-index --find-links=/local/wheels -r requirements.txt

pip uninstall somePackage # 卸载命令
pip uninstall -r requirements.txt # 根据requirements文件卸载

pip search somePackage # 搜索包

pip show somePackage # 显示包的信息

pip list --outdated # 显示所有可以升级的所有的包

配置文件

配置文件路径

pip的配置文件的存放有三种作用范围的配置方式:

  • site-wide
  • per-user
  • per-virtualenv

如果存在多个配置文件,会按照上面的先后顺序去读取文件内容,如果有重复内容,后读取的文件内容会覆盖前面的内容

Linux Mac windows
per-user ${HOME}/.config/pip/pip.conf
${HOME}/.pip/pip.conf(老的配置方式)
${HOME}/Library/Application Support/pip/pip.conf(高优先查找)
${HOME}/.config/pip/pip.conf(低优先查找)
${HOME}/.pip/pip.conf(老的配置方式)
%APPDATA%\pip\pip.ini
%HOME%\pip\pip.ini(老的配置方式)
per-virtualenv $VIRTUAL_ENV/pip.conf $VIRTUAL_ENV/pip.conf %VIRTUAL_ENV%\pip.ini
site-wide /etc/pip.conf /Library/Application Support/pip/pip.conf C:\ProgramData\pip\pip.ini(win7及后续版本)

配置文件内容

1
2
3
4
5
6
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
#proxy=http://[user:passwd@]proxy.server:port

[install]
trusted-host=mirrors.aliyun.com

配置文件中的配置项,都可以在命令行中通过 --<option> 的方式对某一次命令执行进行特殊指定
proxy中账号和密码如果有特殊字符,必须使用 percent-encoded(又称为URI编码)