当你使用Python2.7.9以及Python3.4以上的Python版本时,pip已经默认随Python一起安装,但是你可能需要不定期的更新pip。
pip安装package最常见的就是从PyPI安装,从 PyPI 安装package的命令为:
pip install SomePackage #安装最新的版本
pip install SomePackage==1.0.4 #安装指定版本
pip install 'SomePackage>=1.0.4' #minimum版本
从PyPI用pip安装时,可能因为网络问题发生超时。此时可以指定国内镜像源,命令为:
pip install SomePackage -i http://example.com常用的镜像源有:
如果不希望每次运行pip命令时均手工添加,可以在配置文件中添加
[global] index-url=http://example.com
Whell文件时一个打包的构建好的文件格式,比从源代码build然后install快得多。安装命令:
pip install SomePackage-1.0-py2.py3-none-any.whl
通常源代码中都有setup.py文件,从源代码安装的命令为:
python setup.py install
查看某个package的详细信息命令为:
pip show SomePackage #查看该package详细信息
pip show --files SomePackage #查看该package已安装哪些文件
查看已经安装了哪些package的命令为:
pip list #列出所有已安装的package
pip list --outdated #列出所有outdated package
更新package命令为:
pip install --upgrade SomePackage
卸载package的命令为:
pip uninstall SomePackage
寻找package的命令为:
pip search "query"
pip freeze命令是输出当前已安装package的依赖列表,方便于复制当前已安装的package。命令为:
pip freeze
可以通过重定向输出从而产生requirement文件,命令为: pip freeze > requirements.txt
你也可以从某个requirements文件中读取从而叠加到当前的pip freeze结果中:
pip freeze -r exist_requirements.txt > requirements.txt
如果你是在virtualenv环境中,则通过 pip freeze -l 命令则不会读取globally-installed包(即不会读系统取site-packages目录中的包)
如果你是使用pip freeze --user命令,则只会读取user-site目录中的包
如果有了requirements文件,则通过pip install -r requirements.txt命令可以安装所有的这些包
配置文件有三个级别:系统级别、用户级别、virtualenv级别。其读取顺序为:首先读取系统级别的配置文件,然后读取用户级别的配置文件,最后读取virtualenv级别的配置文件。
如果同样的值在多个配置文件中设置,则最后读取的值会覆盖早期读取的值。
系统级的配置文件位于:
- Unix系统中位于:
/etc/pip.conf。也可以位于由XDG_CONFIG_DIRS环境变量(若存在的话) 指定的目录的名为pip的子目录中,如/etc/xdg/pip/pip.conf - OSX系统中位于:
/Library/Application Support/pip/pip.conf - XP系统中位于:
C:\Documents and Settings\All Users\Application Data\pip\pip.ini - Win7和以后的系统中是hidden的,但是可以写
C:\ProgramData\pip\pip.ini
系统级的配置文件不支持Windows Vista
用户级的pip配置文件位于:
- Unix系统中位于:
$HOME/.config/pip/pip.conf(由XDG_CONFIG_HOME环境变量指定的),或者$HOME/.pip/pip.conf(优先级较低)中 - OSX系统中位于:
$HOME/Library/Application Support/pip/pip.conf - Windows系统中位于:
%APPDATA%\pip\pip.ini或者%HOME%\pip\pip.ini(优先级较低)中
你可以通过环境变量
PIP_CONFIG_FILE来指定这个用户级别的配置文件的位置
你可以在env中设置不同虚拟环境下的配置文件:
- 在Unix/OSX系统中位于:
$VIRTUAL_ENV/pip.conf - 在Windows系统中位于:
%VIRTUAL_ENV%\pip.ini
[global] #针对所有pip命令的配置
timeout = 60 #超时
index-url = http://pypi.douban.com/simple #不同的库url
trusted-host = pypi.douban.com #添加豆瓣源为可信主机,要不然可能报错
disable-pip-version-check = true #取消pip版本检查,排除每次都报最新的pip
[install] #针对具体的pip命令的配置
ignore-installed = true
no-dependencies = yes
Python支持用户级安装。所谓用户级安装用于以下两种情形:
- 当用户没有写
global site-packages目录时 - 当用户不想安装在
global site-packages目录时
用户级安装命令是在常规的install命令后添加--user选项。
安装的目录由PYTHONUSERBASE环境变量决定(该环境变量影响的是site.USER_BASE变量的值)。在Windows7下,这个目录是:C:\Users\huaxz\AppData\Local\pip\cache\wheels
所有的pip命令,这些命令后面添加--user,则会特别针对用户级安装目录。