pip download 命令用于下载包
语法
pip download 命令的语法格式如下
pip [options] [package-index-options] ...
或
pip download [options] -r [package-index-options] ...
或
pip download [options] ...
或
pip download [options] ...
或
pip download [options] ...
pip download 命令可以从以下地址下载包
使用需求说明符从 PiPY 或其它索引上下载
VCS 项目网址
本地项目目录
本地或远程源代码归档
pip 还支持从 「 需求文件 」 ( requirements file ) 下载，这为下载指定的整个环境提供了一种简便方法
简介
pip download 和 pip install 有着相同的解析和下载过程，不同的是，pip install 会安装依赖项，而 pip download 会把所有已下载的依赖项保存到指定的目录 ( 默认是当前目录 )，此目录稍后可以作为值传递给 pip install --find-links 以便离线或锁定下载包安装
如果给 pip download 命令添加选项 --platform、 --python-version、 --implementation 和 --abi 可以用于获取解释器和系统的依赖关系，而不是运行 pip 的解释器和系统的依赖关系，当添加了这些选项时，也必须同时添加 --only-binary=:all: 或 --no-deps
重要的是要注意，上面这些选项都默认为当前系统/解释器，且不是最严格的约束 ( 例如，任何平台，无 abi 等 )。
为了避免获取恰好与当前解释器 ( 但不是你的目标解析器 ) 的约束相匹配的依赖项，如果你指定其中一个，那么建议指定所有这些选项
通用依赖项(例如，通用 wheel ，或没有平台的依赖关系，abi或实现约束 )仍将匹配过度约束的下载要求
选项
-c, --constraint
使用给定的约束文件约束版本，该选项可以重复添加
-r, --requirement
从给定的需求文件中安装，该选项可以重复添加
按照惯例，需求文件名为 requirements.txt
-b, --build
用于存放解压缩的包和构建的包
请注意，初始构建仍发生在临时目录中
可以通过适当地设置 TMPDIR 环境变量 ( Windows上的 TEMP ) 来控制临时目录的位置
注意，如果使用了该参数，当构建发生故障时，并不会清空构建目录
--no-deps
不安装包的任何依赖项
--global-option
在 bdist_wheel 命令之前提供给 setup.py 调用的额外全局选项
--no-binary
不使用二进制包
该选项可以重复添加，每增加一个就会自增当前的值
可选的值有
:all: ：禁用所有二进制包
:none: ：清空集合，或者使用逗号之间的一个或多个包名称
注意，某些软件包编译起来很棘手，并且，即使在添加了此选项后仍然可能无法安装
--only-binary
不使用源代码包
该选项可以重复添加，每增加一个就会自增当前的值
可选的值有
:all: ：禁用所有源代码包
:none: ：清空集合，或者使用逗号之间的一个或多个包名称
注意，没有二进制发行版的软件包在使用此选项时将无法安装
--src
用于存放迁出的可编辑项目
在虚拟环境中，默认的目录为 /src， 在全局安装中，默认的目录为 /src
--pre
包含预发布版本和开发版本，默认只会包行稳定的版本
--no-clean
不要清空构建目录
--require-hashes
对于可重复安装，需要根据哈希值来检查每个需求
如果需求文件中的任何一项包含了 --hash 选项，则隐式包含此选项
--progress-bar
用于指定要显示的进度条类型，可选项有 on、ascii、off、pretty、emoji，默认为 on
--no-build-isolation
在构建现代的源代码分发包是禁用隔离
如果使用了此选项，则必须已安装 PEP518 规定的构建依赖项
-d, --dest
存放已下载的包的目录
--platform
只下载与 平台兼容的 wheel
默认为当前正在运行的系统的平台
--python-version
只下载兼容 Python 解释器版本 的 wheel
如果未指定，默认会使用当前系统解释器的次要版本
可以指定一个主版本号 ( 例如 2 ) 来匹配该主要版本的所有次版本。同时也可以指定次要版本，如 34
--implementation
只下载与 Python 实现 相兼容的 wheel, 例如，pp、jy、 cp 或 ip
如果未指定，那么使用当前解释器实现，可以使用 py 来强制使用与实现无关的 wheel
--abi
只下载与 Python abi 相兼容的 wheel，例如 pypy_41
如果未指定，则使用当前解释器的 abi 标签
通常，在使用该选项时，必须同时指定 --implementation、--platform 和 --python-version
-i, --index-url
Python 包索引的基础 URL 地址，默认为 https://pypi.org/simple
该选项的值应该指向符合 PEP503 ( 简单存储库 API ) 的存储库或以相同格式布局的本地目录
--extra-index-url
除了 --index-url 之外的附加的 Python 包索引 URL，规则和 --index-url 一样
--no-index
忽略包索引，使用 -find-links 指定的 URL
-f, --find-links
如果提供的 URL 或路径链接到一个 html 文件，则会解析该 html 文件以获取归档
如果是本地目录，或 file://url 指向的是一个目录，那么就在该目录中查找归档
--process-dependency-links
启用依赖关系链接的处理
范例
下载一个包及其所有的依赖项
$ pip download SomePackage
$ pip download -d . SomePackage # equivalent to above
$ pip download --no-index --find-links=/tmp/wheelhouse -d /tmp/otherwheelhouse SomePackage
指定使用 OSX 作为解释器的约束，下载包及其所有依赖项
这会强制使用 OSX 10.10 或更低的兼容性。由于 OSX deps 是向前兼容的，这也将匹配 macosx-10_9_x86_64, macosx-10_8_x86_64, macosx-10_8_intel 等等，它还会匹配 deps 与平台 any
还强制解释器版本为 27( 或更通用，即 2 ) 和实现为 cp ( 或更通用，即 py )
$ pip download \
--only-binary=:all: \
--platform macosx-10_10_x86_64 \
--python-version 27 \
--implementation cp \
SomePackage
下载指定的 linux 约束下的包及其依赖项
强制解释器是 py3k 的任何次要版本，并且只接受 abi 为 cp34m或 none 的 requests
$ pip download \
--only-binary=:all: \
--platform linux_x86_64 \
--python-version 3 \
--implementation cp \
--abi cp34m \
requests
$ ls requests*
requests-2.19.1-py2.py3-none-any.whl
强制使用指定的 platform 和 implementation，同时 abi 未知
$ pip download \
--only-binary=:all: \
--platform any \
--python-version 3 \
--implementation py \
--abi none \
requests
$ ls requests*
requests-2.19.1-py2.py3-none-any.whl
即使是过度约束，仍然可以正确的获取 pip 通用的 wheel
$ pip download \
--only-binary=:all: \
--platform linux_x86_64 \
--python-version 33 \
--implementation cp \
--abi cp34m \
pip > 10
$ ls pip-10.0.1-py2.py3-none-any.whl
pip-10.0.1-py2.py3-none-any.whl