python pip使用指南

1. 查询软件包

查询当前环境安装的所有软件包

$ pip list

查询 pypi 上含有某名字的包

$ pip search pkg

查询当前环境中可升级的包

$ pip list --outdated

查询一个包的详细内容

$ pip show pkg

2. 下载软件包

在不安装软件包的情况下下载软件包到本地

$ pip download --destination-directory /local/wheels -r requirements.txt

从目录安装软件包

$ pip install --no-index --find-links=/local/wheels -r requirements.txt

当然你自己也可以构建生成 wheel 文件

$ pip install wheel$ pip wheel --wheel-dir=/local/wheels -r requirements.txt

3. 安装软件包

使用 pip install <pkg> 可以很方便地从 pypi 上搜索下载并安装 python 包。

如下所示

$ pip install requests

这是安装包的基本格式，我们也可以为其添加更多参数来实现不同的效果。

3.1 只从本地安装，而不从 pypi 安装

# 已经下载了软件包$ pip install --no-index --find-links=/local/wheels pkg

3.2 限定版本进行软件包安装

以下三种，对单个 python 包的版本进行了约束

# 所安装的包的版本为 2.1.2$ pip install pkg==2.1.2
# 所安装的包必须大于等于 2.1.2$ pip install pkg>=2.1.2
# 所安装的包必须小于等于 2.1.2$ pip install pkg<=2.1.2

以下命令用于管理/控制整个 python 环境的包版本

# 导出依赖包列表pip freeze >requirements.txt
# 从依赖包列表中安装pip install -r requirements.txt
# 确保当前环境软件包的版本(并不确保安装)pip install -c constraints.txt

3.3 限制不使用二进制包安装

由于默认情况下，wheel 包的平台是运行 pip download 命令 的平台，所以可能出现平台不适配的情况。

# 下载非二进制的包$ pip download --no-binary=:all: pkg
#　安装非二进制的包$ pip install pkg --no-binary

3.4 指定代理服务器安装

$ pip install --proxy [user:passwd@]http_server_ip:port pkg

配置代理：$HOME/.config/pip/pip.conf

对于这个路径，说明几点

•不同的操作系统，路径各不相同

# Linux/Unix:/etc/pip.conf~/.pip/pip.conf~/.config/pip/pip.conf
# Windows:
%APPDATA%\pip\pip.ini%HOME%\pip\pip.iniC:\Documents andSettings\All Users\Application Data\PyPA\pip\pip.conf (Windows XP)C:\ProgramData\PyPA\pip\pip.conf (Windows7及以后) 

•若在你的机子上没有此文件，则自行创建即可

如何配置，这边给个样例：​​​​​​​

[global]index-url = http://mirrors.aliyun.com/pypi/simple/ 
# 替换出自己的代理地址，格式为[user:passwd@]proxy.server:portproxy=http://xxx.xxx.xxx.xxx:8080 
[install]# 信任阿里云的镜像源，否则会有警告trusted-host=mirrors.aliyun.com

3.5 安装用户私有软件包

两种方法：

1.使用虚拟环境

2.将包安装在用户的环境中

命令很简单，只要加上 --user 参数，pip 就会将其安装在当前用户的 ~/.local/lib/python3.x/site-packages 下，而其他用户的 python 则不会受影响。

pip install --user pkg

4. 卸载软件包

$ pip uninstall pkg

5. 升级软件包

$ pip install --upgrade pkg

在升级的时候，其实还有一个不怎么用到的选项 --upgrade-strategy，它是用来指定升级策略。

它的可选项只有两个：

•eager ：升级全部依赖包•only-if-need：只有当旧版本不能适配新的父依赖包时，才会升级。

在 pip 10.0 版本之后，这个选项的默认值是 only-if-need，因此如下两种写法是一互致的。​​​​​​​

pip install --upgrade pkg1 pip install --upgrade pkg1 --upgrade-strategy only-if-need