选项¶
-r, --requirement
从给定的需求文件安装。此选项可以使用多次。
(环境变量：PIP_REQUIREMENT)
-c, --constraint
使用给定的约束文件限制版本。此选项可以使用多次。
(环境变量：PIP_CONSTRAINT)
--no-deps¶
不要安装软件包依赖项。
(环境变量：PIP_NO_DEPS，PIP_NO_DEPENDENCIES)
--pre¶
包含预发布和开发版本。默认情况下，pip 只找到稳定版本。
(环境变量：PIP_PRE)
-e, --editable
以可编辑模式（即 setuptools 的“开发模式”）从本地项目路径或 VCS URL 安装项目。
(环境变量：PIP_EDITABLE)
--dry-run¶
实际上不安装任何内容，只打印将要安装的内容。可以与 --ignore-installed 结合使用来“解析”需求。
(环境变量：PIP_DRY_RUN)
-t, --target
将软件包安装到
(环境变量：PIP_TARGET)
--platform
只使用与
(环境变量：PIP_PLATFORM)
--python-version
用于 wheel 和“Requires-Python”兼容性检查的 Python 解释器版本。默认设置为从运行的解释器派生的版本。版本可以使用最多三个用点分隔的整数指定（例如，“3”表示 3.0.0，“3.7”表示 3.7.0 或“3.7.3”）。也可以将主版本和次版本作为没有点的字符串给出（例如，“37”表示 3.7.0）。
(环境变量：PIP_PYTHON_VERSION)
--implementation
只使用与 Python 实现
(环境变量：PIP_IMPLEMENTATION)
--abi
只使用与 Python abi
(环境变量：PIP_ABI)
--user¶
安装到平台的 Python 用户安装目录。通常为 ~/.local/，或 Windows 上的 %APPDATA%Python。（有关详细信息，请参见 Python 文档中有关 site.USER_BASE 的内容。）
(环境变量：PIP_USER)
--root
将所有内容相对于此备用根目录安装。
(环境变量：PIP_ROOT)
--prefix
安装 lib、bin 和其他顶级文件夹所在的安装前缀。请注意，生成的安装可能包含引用 pip 的 Python 解释器（而不是 --prefix 的 Python 解释器）的脚本和其他资源。如果要将软件包安装到另一个（可能是无 pip 的）环境中，请参阅 --python 选项。
(环境变量：PIP_PREFIX)
--src
用于签出可编辑项目的目录。虚拟环境中的默认目录为“
(环境变量：PIP_SRC，PIP_SOURCE，PIP_SOURCE_DIR，PIP_SOURCE_DIRECTORY)
-U, --upgrade¶
将所有指定的软件包升级到最新版本。依赖项的处理方式取决于使用的升级策略。
(环境变量：PIP_UPGRADE)
--upgrade-strategy
确定如何处理依赖项升级 [默认：only-if-needed]。“eager” - 无论当前安装的版本是否满足升级的软件包的要求，都会升级依赖项。“only-if-needed” - 仅当依赖项不满足升级的软件包的要求时才升级。
(环境变量：PIP_UPGRADE_STRATEGY)
--force-reinstall¶
重新安装所有软件包，即使它们已经是最新版本。
(环境变量：PIP_FORCE_REINSTALL)
-I, --ignore-installed¶
忽略已安装的软件包，覆盖它们。如果现有软件包版本不同或使用不同的软件包管理器安装，这可能会破坏您的系统！
(环境变量：PIP_IGNORE_INSTALLED)
--ignore-requires-python¶
忽略 Requires-Python 信息。
(环境变量：PIP_IGNORE_REQUIRES_PYTHON)
--no-build-isolation¶
在构建现代源代码发行版时禁用隔离。如果使用此选项，则必须已安装 PEP 518 指定的构建依赖项。
(环境变量: PIP_NO_BUILD_ISOLATION)
--use-pep517¶
使用 PEP 517 构建源代码分发包（使用 --no-use-pep517 强制使用旧式行为）。
(环境变量: PIP_USE_PEP517)
--check-build-dependencies¶
在使用 PEP517 时检查构建依赖项。
(环境变量: PIP_CHECK_BUILD_DEPENDENCIES)
--break-system-packages¶
允许 pip 修改外部管理的 Python 安装。
(环境变量: PIP_BREAK_SYSTEM_PACKAGES)
-C, --config-settings
要传递给 PEP 517 构建后端的配置设置。设置采用 KEY=VALUE 的形式。使用多个 --config-settings 选项将多个键传递给后端。
(环境变量: PIP_CONFIG_SETTINGS)
--global-option
要在安装或 bdist_wheel 命令之前提供给 setup.py 调用的额外全局选项。
(环境变量: PIP_GLOBAL_OPTION)
--compile¶
将 Python 源代码文件编译为字节码。
(环境变量: PIP_COMPILE)
--no-compile¶
不要将 Python 源代码文件编译为字节码。
(环境变量: PIP_NO_COMPILE)
--no-warn-script-location¶
在将脚本安装到 PATH 之外时不要发出警告。
(环境变量: PIP_NO_WARN_SCRIPT_LOCATION)
--no-warn-conflicts¶
不要警告有关损坏的依赖项。
(环境变量: PIP_NO_WARN_CONFLICTS)
--no-binary
不要使用二进制软件包。可以多次提供，每次都会添加到现有值中。接受“：all：”以禁用所有二进制软件包，“：none：”以清空集合（注意冒号），或用逗号分隔的一个或多个软件包名称（没有冒号）。请注意，某些软件包很难编译，并且在对这些软件包使用此选项时可能无法安装。
(环境变量: PIP_NO_BINARY)
--only-binary
不要使用源代码软件包。可以多次提供，每次都会添加到现有值中。接受“：all：”以禁用所有源代码软件包，“：none：”以清空集合，或用逗号分隔的一个或多个软件包名称。在对这些软件包使用此选项时，没有二进制分发的软件包将无法安装。
(环境变量: PIP_ONLY_BINARY)
--prefer-binary¶
优先使用二进制软件包而不是源代码软件包，即使源代码软件包更新。
(环境变量: PIP_PREFER_BINARY)
--require-hashes¶
要求使用哈希值来检查每个需求，以实现可重复安装。如果需求文件中任何软件包都有 --hash 选项，则会隐式使用此选项。
(环境变量: PIP_REQUIRE_HASHES)
--progress-bar
指定是否应使用进度条 [on, off, raw]（默认：on）
(环境变量: PIP_PROGRESS_BAR)
--root-user-action
如果 pip 作为 root 用户运行，则采取的操作 [warn, ignore]（默认：warn）
(环境变量: PIP_ROOT_USER_ACTION)
--report
生成一个 JSON 文件，描述 pip 为安装提供的需求所做的事情。可以与 --dry-run 和 --ignore-installed 结合使用以“解析”需求。当使用 - 作为文件名时，它会写入 stdout。当写入 stdout 时，请与 --quiet 选项结合使用，以避免将 pip 日志输出与 JSON 输出混合。
(环境变量: PIP_REPORT)
--no-clean¶
不要清理构建目录。
(环境变量: PIP_NO_CLEAN)
-i, --index-url
Python 软件包索引的基 URL（默认 https://pypi.ac.cn/simple）。这应该指向一个符合 PEP 503（简单存储库 API）的存储库或以相同格式布局的本地目录。
(环境变量: PIP_INDEX_URL, PIP_PYPI_URL)
--extra-index-url
要除了 --index-url 之外使用的软件包索引的额外 URL。应遵循与 --index-url 相同的规则。
(环境变量: PIP_EXTRA_INDEX_URL)
--no-index¶
忽略软件包索引（只查找 --find-links URL）。
(环境变量: PIP_NO_INDEX)
-f, --find-links
如果为 URL 或指向 html 文件的路径，则解析到存档的链接，例如 sdist (.tar.gz) 或 wheel (.whl) 文件。如果为本地路径或 file:// URL，即目录，则在目录列表中查找存档。不支持指向 VCS 项目 URL 的链接。
(环境变量: PIP_FIND_LINKS)