pip¶
用法¶
python -m pip <command> [options]
py -m pip <command> [options]
描述¶
日志记录¶
控制台日志记录¶
pip 提供 -v, --verbose 和 -q, --quiet 来控制控制台日志级别。默认情况下，某些消息（错误和警告）在终端中会以彩色显示。如果你想禁止彩色输出，请使用 --no-color。
文件日志记录¶
pip 提供 --log 选项来指定保存最大详细程度日志的文件。默认情况下此选项为空。此日志附加到之前的日志记录。
与所有 pip 选项一样，--log 也可以设置为环境变量，或放置在 pip 配置文件中。请参阅 配置 部分。
--exists-action 选项¶
此选项指定路径已存在时的默认行为。可能的情况：下载文件或检出存储库以进行安装，创建存档。如果未定义 --exists-action，pip 将在需要决策时提示。
- (s)witch
仅与 VCS 检出相关。尝试将检出切换到相应的 URL 和/或修订版。
- (i)gnore
中止当前操作（例如，不复制文件，不创建存档，不修改检出）。
- (w)ipe
在尝试创建、下载或检出新文件之前，删除文件或 VCS 检出。
- (b)ackup
将文件或检出重命名为
{name}{'.bak' * n}，其中 n 是某个数字的.bak扩展名，因此文件在某个时间点不存在。因此，最近的备份将是.bak后面具有最大数字的备份。- (a)bort
中止 pip 并返回非零退出状态。
构建系统接口
现在已包含在 构建系统接口 中。
通用选项¶
- -h, --help¶
显示帮助。
(环境变量:
PIP_HELP)
- --debug¶
让未处理的异常传播到主子例程之外，而不是将它们记录到 stderr。
(环境变量:
PIP_DEBUG)
- --isolated¶
以隔离模式运行 pip，忽略环境变量和用户配置。
(环境变量:
PIP_ISOLATED)
- --require-virtualenv¶
允许 pip 仅在虚拟环境中运行；否则退出并报错。
(环境变量:
PIP_REQUIRE_VIRTUALENV,PIP_REQUIRE_VENV)
- --python <python>¶
使用指定的 Python 解释器运行 pip。
(环境变量:
PIP_PYTHON)
- -v, --verbose¶
提供更多输出。选项是累加的，最多可以使用 3 次。
(环境变量:
PIP_VERBOSE)
- -V, --version¶
显示版本并退出。
(环境变量:
PIP_VERSION)
- -q, --quiet¶
提供更少的输出。选项是累加的，最多可以使用 3 次（对应于 WARNING、ERROR 和 CRITICAL 日志级别）。
(环境变量:
PIP_QUIET)
- --log <path>¶
详细附加日志的路径。
(环境变量:
PIP_LOG,PIP_LOG_FILE,PIP_LOCAL_LOG)
- --no-input¶
禁用提示输入。
(环境变量:
PIP_NO_INPUT)
- --keyring-provider <keyring_provider>¶
如果允许用户输入，则启用通过 keyring 库进行凭据查找。指定要使用的机制 [disabled, import, subprocess]。（默认：disabled）
(环境变量:
PIP_KEYRING_PROVIDER)
- --proxy <proxy>¶
以 scheme://[user:passwd@]proxy.server:port 的形式指定代理。
(环境变量:
PIP_PROXY)
- --retries <retries>¶
每个连接应尝试的最大重试次数（默认 5 次）。
(环境变量:
PIP_RETRIES)
- --timeout <sec>¶
设置套接字超时（默认 15 秒）。
(环境变量:
PIP_TIMEOUT,PIP_DEFAULT_TIMEOUT)
- --exists-action <action>¶
路径已存在时的默认操作: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort。
(环境变量:
PIP_EXISTS_ACTION)
- --trusted-host <hostname>¶
将此主机或主机:端口对标记为受信任，即使它没有有效的或任何 HTTPS。
(环境变量:
PIP_TRUSTED_HOST)
- --cert <path>¶
PEM 编码的 CA 证书捆绑包的路径。 如果提供，则覆盖默认值。 有关更多信息，请参阅 pip 文档中的“SSL 证书验证”。
(环境变量:
PIP_CERT)
- --client-cert <path>¶
SSL 客户端证书的路径，一个包含私钥和证书的 PEM 格式的单个文件。
(环境变量:
PIP_CLIENT_CERT)
- --cache-dir <dir>¶
将缓存数据存储在 <dir> 中。
(环境变量:
PIP_CACHE_DIR)
- --no-cache-dir¶
禁用缓存。
(环境变量:
PIP_NO_CACHE_DIR)
- --disable-pip-version-check¶
不要定期检查 PyPI 以确定是否可以下载 pip 的新版本。 隐含于 --no-index 中。
(环境变量:
PIP_DISABLE_PIP_VERSION_CHECK)
- --no-color¶
抑制彩色输出。
(环境变量:
PIP_NO_COLOR)
- --no-python-version-warning¶
静默即将不支持的 Python 的弃用警告。
(环境变量:
PIP_NO_PYTHON_VERSION_WARNING)
- --use-feature <feature>¶
启用新的功能，这些功能可能不向后兼容。
(环境变量:
PIP_USE_FEATURE)
- --use-deprecated <feature>¶
启用已弃用的功能，这些功能将在将来删除。
(环境变量:
PIP_USE_DEPRECATED)