pip指南

配置文件

配置文件路径：

• Unix: ~/.pip/pip.conf
• Windows: %HOMEPATH%pippip.ini

当然，如果你想自定义配置文件的存放路径，你可以将你自定义的路径保存到环境变量 PIP_ONFIG_FILE 。

配置文件的格式类似于 INI 文件。

当你想添加一个对所有命令都生效的参数时，可以将该配置放置在 [global] 段中。例如：

1
2
3

[global]
timeout = 60
index-url = http://pypi.douban.com/simple

如果你想针对 pip 的某个子命令进行配置的话，可以将该子命令名称当作段名称，该段内的配置与 [global] 中的配置冲突则会覆盖之。

• 比如 freeze 子命令：

  1 2	[freeze] timeout = 10

• 比如 install 子命令：

  1 2 3 4 5 6

  [install] ignore-installed = true no-dependencies = yes find-links = http://mirror1.example.com http://mirror2.example.com

环境变量

pip 的命令行参数也可以通过环境变量来设置。

它的格式为： PIP_<UPPER_LONG_NAME> 。

• 比如设置超时：

  1	$ export PIP_DEFAULT_TIMEOUT=60

  其效果等于：

  1	$ pip --default-timeout=60 [...]

• 比如设置 find-links：

  1	$ export PIP_FIND_LINKS="http://mirror1.example.com http://mirror2.example.com"

  其效果等于：

  1 2	$ pip install --find-links=http://mirror1.example.com --find-links=http://mirror2.example.com

配置的优先级

刚才讲到一个参数的三种配置方法优先级顺序是：

1. 命令行
2. 环境变量
3. 配置文件

命令的自动补全

用过 bash/zsh 环境的人都知道有自动补全功能。

pip 命令想要自动补全功能的话，可以运行以下命令：

1
2
3

$ pip completion --bash >> ~/.profile

$ pip completion --zsh >> ~/.zprofile

加入到 profile 文件后，需要重新进入 bash/zsh 环境才能生效，你也可以运行以下命令，立即生效自动补全功能：

1

$ eval "`pip completion --bash`"

使用方法

1
2
3
4
5
6
7
8
9

$ pip install [options] <requirement specifier> ...

$ pip install [options] -r <requirements file> ...

$ pip install [options] [-e] <vcs project url> ...

$ pip install [options] [-e] <local project path> ...

$ pip install [options] <archive url/path> ...

本地快速安装

1. 下载你所需要的所有的 Python 包

1

$ pip install --download <DIR> -r requirements.txt

2. 使用以下命令即可安装刚才下载到本地的 Python 包

1

$ pip install --no-index --find-links=[file://]<DIR> -r requirements.txt

非递归式升级

其实就是只升级你需要的包，但是该包所依赖的包不安装 / 升级。

1

$ pip install --upgrade --no-deps SomePackage

特定用户安装

从 Python2.6 开始，Python 就支持将 Python 包安装到指定的用户目录了。

该用户的目录默认值是由 site.USER_BASE 所指定的。

如果想覆盖该值，则使用环境变量 PYTHONUSERBASE 。

可以通过 --user 参数来指定特定用户。

1
2

$ export PYTHONUSERBASE=/myappenv
$ pip install --user SomePackage

使用方法

1
2
3

$ pip uninstall [options] <package> ...

$ pip uninstall [options] -r <requirements file> ...

已知缺陷

目前已知的两种无法正常删除的情况：

• 完全使用 disutils 模块制定的 Python 包，且通过 python setup.py install 来安装的。这种包没有什么元信息能够知道它倒底安装了哪些文件。
• 通过 python setup.py develp 来安装的脚本。

参数

使用方法

1

$ pip freeze [options]

参数

常见应用场景

当你需要将一个 virtualenv 环境中复制到另外一个 virtualenv 环境时，你可以先在源 virtualenv 环境运行命令：

1

$ pip freeze > requirements.txt

然后再进入目的 virtualenv 环境运行命令：

1

$ pip install -r requirements.txt

这样就完成了虚拟环境的复制过程。

这时可能有人会问，virtualenv 环境不就是一个目录么，直接拷贝一下，不就一个跟原来一样的新的 virtualenv 环境么？

好吧，我觉得这方法一般情况也可以的。

但是如果源 virtualenv 环境和目的 virtualenv 环境的 Python 版本或者操作系统不一样，建议你还是老实地按照上面的说做吧。

使用方法

1

$ pip list [options]

参数

使用方法

1

$ pip show [options] <package> ...

参数

使用方法

1

$ pip search [options] <query>

参数

使用方法

1
2
3
4
5
6
7
8
9

$ pip pip wheel [options] <requirement specifier> ...

$ pip wheel [options] -r <requirements file> ...

$ pip wheel [options] <vcs project url> ...

$ pip wheel [options] <local project path> ...

$ pip wheel [options] <archive url/path> ...

参数

常见应用场景

先将需要的所有第三方 Python 包打包到本地目录，然后再从本地目录直接安装之前已经打包好的 wheel 格式的 Python 包。

1
2

$ pip wheel --wheel-dir=/tmp/wheelhouse SomePackage
$ pip install --no-index --find-links=/tmp/wheelhouse SomePackage

国内镜像源

• 豆瓣 PyPI
• 华中理工大学 PyPI
• 山东理工大学 PyPI ， 这个貌似用不了。
• 中国科学技术大学 PyPI

可以用 pip 的 -i 参数来指定镜像源。

1

$ pip install gevent -i http://pypi.douban.com/simple

如果不想每次手动指定，且永久有效的话，可以写入到 pip 的配置文件中。

1
2

[global]
index-url = http://pypi.douban.com/simple