Python：pip 命令详解与示例

pip 是 Python 的内置工具，用于安装、卸载、查询和管理 Python 包。通过 pip，用户可以轻松地获取第三方库并将其集成到自己的项目中。

pip 需要通过命令行方式执行。

命令格式：

python.exe -m pip <command> [options]或者pip <command> [options]

使用 Python 的 pip 模块执行子命令，可通过 <command> 传入功能操作，再附带所需选项参数。

🧭 Commands 命令列表

install    

安装一个第三方库。

// 例 1：默认从网络上下载 pillow 库（用于图像处理）并自动安装到系统中。若已安装则更新。pip install -U pillow
// 例 2：pygame 包用于简单小游戏开发pip install pygame
// 例 3：安装本地软件包，无需联网，但要指定文件名及路径pip install .\networkx-3.4.2-py3-none-any.whl

download    

下载软件包（.whl 或 .tar.gz），但并不进行安装。

// 例：下载 numpy（用于矩阵运算）安装包pip download numpy

uninstall    

卸载一个第三方库。

// 例：卸载 flask 包（轻量级 Web 开发框架），会提示是否确认删除。pip uninstall flask

freeze    

以 requirements 格式输出已安装软件包。

// 例：将当前环境中所有安装包及版本导出到 requirements.txt 文件中。pip freeze > requirements.txt

inspect

检查 Python 环境信息，包括依赖结构。需要 pip 23.1+。

// 例：pip inspect

list    

列出当前系统中已经安装的第三方库及其版本号。

// 例：列出所有已安装的包，并显示可升级版本。pip list --outdated

show   

显示已安装软件包的详细信息。

// 例：查看 pillow 包的详细信息，如版本、作者、安装路径等。pip show pillow

check    

检查当前已安装包之间的依赖关系是否存在冲突。

// 例：检查当前已安装包之间的依赖关系是否存在冲突。pip check

config   

配置 pip 的本地和全局设置。

// 例 1：列出所有的 pip 配置项（例如镜像源、缓存路径等）。pip config list// 例 2：获取 pip config 命令的帮助pip config -h

search    

在 PyPI 上搜索软件包（目前已废弃）。

// 例：从 PyPI 搜索含有 “http” 关键词的包（目前已废弃）。pip search http

cache    

检查和管理 pip 的缓存。

// 例：查看 pip 使用的缓存目录。pip cache dir

index    

查看索引中的包信息。需要 pip 21.2+。

// 例：查看 requests 包（用于 http 协议访问）在索引源上所有可用版本。pip index versions requests

wheel    

构建 wheel 格式软件包。仅构建，不安装。

// 例：将 requests 包构建为 wheel 格式。pip wheel requests

hash    

计算包的哈希值。

// 例：pip hash networkx-3.4.2-py3-none-any.whl

completion    

用于生成 pip 命令的自动补全脚本，让用户在命令行中可以使用 Tab 键自动补全 pip 命令、参数和包名，从而提高效率、减少输入错误。

// 例：生成适用于 Bash 的补全脚本。pip completion --bash

debug    

显示调试信息。

// 例：输出详细的 pip 环境信息，用于调试环境问题。pip debug --verbose

help    

显示帮助命令列表。

// 例：显示 install 命令的详细帮助说明和可用参数。pip help install

⚙️ General Options 通用选项

-h, --help    

显示帮助信息。

--debug    

让未捕获的异常直接抛出，而不是记录日志。

--isolated    

以隔离模式运行，忽略环境变量和用户配置。

--require-virtualenv    

只允许在虚拟环境中运行 pip。

--python <python>    

使用指定的 Python 解释器运行 pip。

-v, --verbose    

输出更详细信息，可叠加最多 3 次。

-V, --version    

显示 pip 版本号并退出。

-q, --quiet    

安静模式，减少输出信息，最多 3 层。

--log <path>    

将详细日志输出到文件。

--no-input    

禁用所有交互提示。

--keyring-provider <provider>

启用 keyring 凭据支持，可设为 auto、disabled 等。

--proxy <proxy>    

设置 HTTP 代理（scheme://[user:passwd@]host:port）。

--retries <retries>    

设置最大重试次数，默认 5 次。

--timeout <sec>    

设置连接超时时间，默认 15 秒。

--exists-action <action>    

已存在文件时的操作（s: switch, i: ignore, w: wipe, b: backup, a: abort）。

--trusted-host <hostname>    

将指定主机标记为可信，即使其无有效 HTTPS 证书。

--cert <path>    

使用自定义 PEM 格式证书文件。

--client-cert <path>    

使用 SSL 客户端证书。

--cache-dir <dir>    

设置 pip 缓存目录路径。

--no-cache-dir    

禁用缓存。

--disable-pip-version-check    

禁用 pip 启动时的版本更新检查。

--no-color    

禁用颜色输出。

--use-feature <feature>    

启用实验功能。

--use-deprecated <feature>    

启用已弃用功能。未来可能被移除

--resume-download    

恢复中断的下载。

--resume-retries <number>    

设置恢复下载时的最大重试次数（Default: 0）。

“点赞有美意，赞赏是鼓励”