pip官方文档

以下内容是根据pip的1.5.X版本的官方文档写的笔记。

官方文档有用户指南专门一章节， 我翻译时将之分割到多个章节中去了。

可以下载 get-pip.py ， 运行命令：

$ python get-pip.py

如果setuptools没有安装，该命令同时也会安装它。

如果已经安装了setuptools库，那么可以通过easy_install安装：

$ easy_install pip

在Linux系统上：

$ pip insall -U pip

在Windows系统上：

$ python -m pipi install -U pip

• 安装包

  $ pip install SomePackage

• 升级包

  $ pip install --upgrade SomePackage
  
  $ pip install -U SomePackage

• 删除包

  $ pip uninstall SomePackage

• 查看某个包安装了哪些文件

  $ pip show --files SomePackage

• 列出哪些包过期了，或者说是有新的版本了

  $ pip list --outdated

配置文件路径：

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

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

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

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

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

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

• 比如 freeze 子命令：

  [freeze]
  timeout = 10

• 比如 install 子命令：

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

pip的命令行参数也可以通过环境变量来设置。 它的格式为： PIP_<UPPER_LONG_NAME> 。

• 比如设置超时：

  $ export PIP_DEFAULT_TIMEOUT=60

  其效果等于：

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

• 比如设置find-links：

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

  其效果等于：

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

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

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

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

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

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

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

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

$ eval "`pip completion --bash`"

安装Python包

$ 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包

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

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

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

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

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

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

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

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

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

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

卸载Python包

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

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

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

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

将当前Python环境所有的安装包名输出成requirements格式。

$ pip freeze [options]

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

$ pip freeze > requirements.txt

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

$ pip install -r requirements.txt

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

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

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

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

列出当前环境所有已经安装的Python包，包括可编辑的包（including editables）。

好像功能和 pip freeze 功能差不多的么， 只是输出的格式不一样。

可编辑的包是啥意思？暂时还不清楚。

$ pip list [options]

列出一个或者多个包的信息

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

从 Python Package Index 上查找 Python包名或者其简要描述中包含关键字（<query>）的Python包。

$ pip search [options] <query>

创建wheel格式的Python包

使用该参数，需要您的环境安装setuptools >= 0.8，并且安装了wheel。

pip wheel 使用setuptools扩展 bdist_wheel 来制作wheel格式的Python包。

如果想更多了解wheel，请看 wheel官方文档 。

$ 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包。

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

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

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

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

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

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