python包管理工具pip使用手册
pip是什么?
pip
是 Python 标准库管理器,也就是一个工具让你安装不同的类库来使用。
当你要安装某些类库时,都会使用 pip
,那 pip
除了安装类库之外,还能做什么呢?
首先,我们进入 cmd终端,输入 pip,查看当前 pip 的命令集合。
$ pip
Usage:
pip <command> [options]
Commands:
install Install packages.
download Download packages.
uninstall Uninstall packages.
freeze Output installed packages in requirements format.
list List installed packages.
show Show information about installed packages.
check Verify installed packages have compatible dependencies.
config Manage local and global configuration.
search Search PyPI for packages.
cache Inspect and manage pip's wheel cache.
index Inspect information available from package indexes.
wheel Build wheels from your requirements.
hash Compute hashes of package archives.
completion A helper command used for command completion.
debug Show information useful for debugging.
help Show help for commands.
General Options:
-h, --help Show help.
--debug Let unhandled exceptions propagate outside the
main subroutine, instead of logging them to
stderr.
--isolated Run pip in an isolated mode, ignoring environment
variables and user configuration.
--require-virtualenv Allow pip to only run in a virtual environment;
exit with an error otherwise.
-v, --verbose Give more output. Option is additive, and can be
used up to 3 times.
-V, --version Show version and exit.
-q, --quiet Give less output. Option is additive, and can be
used up to 3 times (corresponding to WARNING,
ERROR, and CRITICAL logging levels).
--log <path> Path to a verbose appending log.
--no-input Disable prompting for input.
--proxy <proxy> Specify a proxy in the form
[user:passwd@]proxy.server:port.
--retries <retries> Maximum number of retries each connection should
attempt (default 5 times).
--timeout <sec> Set the socket timeout (default 15 seconds).
--exists-action <action> Default action when a path already exists:
(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.
--trusted-host <hostname> Mark this host or host:port pair as trusted, even
though it does not have valid or any HTTPS.
--cert <path> Path to PEM-encoded CA certificate bundle. If
provided, overrides the default. See 'SSL
Certificate Verification' in pip documentation
for more information.
--client-cert <path> Path to SSL client certificate, a single file
containing the private key and the certificate in
PEM format.
--cache-dir <dir> Store the cache data in <dir>.
--no-cache-dir Disable the cache.
--disable-pip-version-check
Don't periodically check PyPI to determine
whether a new version of pip is available for
download. Implied with --no-index.
--no-color Suppress colored output.
--no-python-version-warning
Silence deprecation warnings for upcoming
unsupported Pythons.
--use-feature <feature> Enable new functionality, that may be backward
incompatible.
--use-deprecated <feature> Enable deprecated functionality, that will be
removed in the future.
commands | 原指令解释 | 翻译 |
---|---|---|
install | Install package | 安装python包 |
download | download package | 下载python包 |
uninstall | Uninstall package | 卸载python包 |
freeze | Output installed package in requirements format | 按照一定格式输出安装好的包 |
list | List installed packages | 列出安装了的python包 |
show | Show information about installed packages | 详细展示安装了的python包的信息 |
check | Verify installed packages have compatible dependencies | 检验安装了的python包有相互依赖性 |
search | Search PyPI for packages | 查询python包的镜像依赖(PyPI) |
wheel | Builds wheels from your requirements | 建立你的需求的安装路径 |
hash | Compute hashes of package archives | 计算包装档案的关键字 |
completion | A helper command used for command completion | 一个帮助指令用作指令完成 |
help | Show help for commands | 显示该项指令如何使用 |
pip --version
只要在终端输入 pip --version
或者 pip -V
就能得到当前系统安装的 pip
版本,同时也会知道对应的 Python 版本。
$ pip --version
pip 22.0.4 from /Users/niuben/opt/anaconda3/lib/python3.9/site-packages/pip (python 3.9)
$ pip -V
pip 22.0.4 from /Users/niuben/opt/anaconda3/lib/python3.9/site-packages/pip (python 3.9)
pip升级
sudo python3 -m pip install --upgrade pip
pip list 查询当前已安装类库
$ pip list
Package Version
---------------------------------- --------------------
alabaster 0.7.12
anaconda-client 1.9.0
anaconda-navigator 2.1.1
anaconda-project 0.10.1
anyio 2.2.0
appdirs 1.4.4
applaunchservices 0.2.1
appnope 0.1.2
appscript 1.1.2
argh 0.26.2
argon2-cffi 20.1.0
arrow 0.13.1
asn1crypto 1.4.0
astroid 2.6.6
astropy 4.3.1
async-generator 1.10
atomicwrites 1.4.0
attrs 21.2.0
autopep8 1.5.7
Babel 2.9.1
在安装包之前,先看一下这个包否已安装,或者当前包的版本,使用如下命令:
pip list -o
pip install 安装类库
默认情况下 pip 使用的是国外的镜像,在下载的时候速度非常慢,下载速度是几kb或者几十kb,花费的时间比较长,请移步查看 python 更新pip镜像源
安装类库时,只需要使用 pip install --upgrade 包名称
就可以安装对应的类库了
如果没有对应的类库,就会安装失败,提示找不到
$ pip install --upgrade zipp # 由于已经安装,会提示已安装并说明类库安装位置
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Requirement already satisfied: zipp in ./opt/anaconda3/lib/python3.9/site-packages (3.6.0)
$ pip install --upgrade zip111 # 输入错误的包名,会提示错误,找不到
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProxyError('Cannot connect to proxy.', timeout('_ssl.c:1112: The handshake operation timed out'))': /pypi/simple/zipp111/
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProxyError('Cannot connect to proxy.', timeout('_ssl.c:1112: The handshake operation timed out'))': /pypi/simple/zipp111/
ERROR: Could not find a version that satisfies the requirement zipp111 (from versions: none)
ERROR: No matching distribution found for zipp111
有时候我们需要安装指定版本的类库,新版本有时候会出现一些兼容问题,导致冲突
这时候安装类库包时,可以使用 pip install --upgrade 包名称==版本号
指定版本号
$ pip install --upgrade zipp==3.6.0
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Collecting zipp==3.6.0
Downloading https://mirrors.aliyun.com/pypi/packages/bd/df/d4a4974a3e3957fd1c1fa3082366d7fff6e428ddb55f074bf64876f8e8ad/zipp-3.6.0-py3-none-any.whl (5.3 kB)
Installing collected packages: zipp
Attempting uninstall: zipp
Found existing installation: zipp 3.8.0
Uninstalling zipp-3.8.0:
Successfully uninstalled zipp-3.8.0
Successfully installed zipp-3.6.0
有时候安装完类库时,会提示你升级 pip,当然升级下最好啦
python3 -m pip install –upgrade pip => 升級 pip 套件
pip show 了解指定类库资讯
使用 pip show <包名>
,可以更加详细了解类库相关说明
pip show Babel
Name: Babel
Version: 2.9.1
Summary: Internationalization utilities
Home-page: http://babel.pocoo.org/
Author: Armin Ronacher
Author-email: armin.ronacher@active-4.com
License: BSD
Location: /Users/niuben/opt/anaconda3/lib/python3.9/site-packages
Requires: pytz
Required-by: jupyterlab-server, Sphinx
pip uninstall 卸载类库
当你不需要这个类库或者觉得太占空间时,可以使用 pip uninstall <类库名>
,卸载对应的类库
在删除的时候,会询问你一次,是否确定删除
如果真的删除了,需要时,可以再通过 pip install <类库名>
安装回来
$ pip uninstall zipp
Found existing installation: zipp 3.6.0
Uninstalling zipp-3.6.0:
Would remove:
/Users/niuben/opt/anaconda3/lib/python3.9/site-packages/zipp-3.6.0.dist-info/*
/Users/niuben/opt/anaconda3/lib/python3.9/site-packages/zipp.py
Proceed (Y/n)? y
Successfully uninstalled zipp-3.6.0
$ pip install zipp
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Collecting zipp
Downloading https://mirrors.aliyun.com/pypi/packages/80/0e/16a7ee38617aab6a624e95948d314097cc2669edae9b02ded53309941cfc/zipp-3.8.0-py3-none-any.whl (5.4 kB)
Installing collected packages: zipp
Successfully installed zipp-3.8.0
pip freeze 列出所有安装类库
pip list
不就能列出所有安装的类库吗?那为什么还有 pip freeze
呢?
pip list
列出的是所有安装的类库包,可并不是所有的类库包都可以删除的,例如:pip、setuptools等等
它们就像是手机中预载的系统app,没有办法删除,而通过 pip freeze
可以取出自己安装过的类库包
当然如果一定要用 pip freeze
来显示所有包,可以加上参数 --all
,就可以啦
pip freeze > requirements.txt 将本地安装包导出写入文本
当我们换电脑或者使用新的系统来跑当前 Python 相同的代码时,可以一键安装对应的类库,以及轻松搞定类库版本问题
换系统时,有时候会因为某些类库或者版本问题,造成冲突或者异常,不如直接导出到 txt 文本中,再通过安装的方式,快速复制一套 Python 开发环境,省时又省力。
$ pip freeze > requirements.txt # 把电脑的已安装的类库包,导出到 requirements.txt
$ cat requirements.txt # 查看 requirements.txts 內容
cat requirements.txt
alabaster @ file:///home/ktietz/src/ci/alabaster_1611921544520/work
anaconda-client @ file:///opt/concourse/worker/volumes/live/866d4dd0-ff5b-4d0b-718d-0267a3b10e06/volume/anaconda-client_1635342573767/work
anaconda-navigator==2.1.1
anaconda-project @ file:///tmp/build/80754af9/anaconda-project_1626085644852/work
anyio @ file:///opt/concourse/worker/volumes/live/96440bbe-d2f1-4a9e-5edf-600248ff38bd/volume/anyio_1617783321037/work/dist
appdirs==1.4.4
applaunchservices @ file:///Users/ktietz/demo/mc3/conda-bld/applaunchservices_1630511705208/work
appnope @ file:///opt/concourse/worker/volumes/live/6ca6f098-d773-4461-5c91-a24a17435bda/volume/appnope_1606859448531/work
appscript @ file:///opt/concourse/worker/volumes/live/00049ed6-6263-4a6e-72b9-9d990f6e2f07/volume/appscript_1611427000595/work
argh==0.26.2
argon2-cffi @ file:///opt/concourse/worker/volumes/live/38e8fb2b-1295-4bdf-4adf-b20acbe4d91b/volume/argon2-cffi_1607022498041/work
arrow @ file:///opt/concourse/worker/volumes/live/1c202787-83f7-4b70-6d98-b40769f597f4/volume/arrow_1617737667847/work
asn1crypto @ file:///tmp/build/80754af9/asn1crypto_1596577642040/work
...
这时候在另一套新系统终端上执行 pip install -r requirements.txt
,就能快速将旧系统原有的类库安装到新系统上了。
pip install -r requirements.txt
pip 整理本地安装类库
可以先执行 pip freeze > requirements.txt
导出所有已安装类库包,然后再修改 requirements.txt
,将需要删除的类库保留,然后执行 pip uninstall -r requirements.txt
就能快速删除指定的类库了,如果需要恢复,再执行pip install -r requirements.txt
即可。