Python pip使用教程:怎么安装、更新与卸载第三方库
系统讲解 Python 官方包管理工具 pip 的实用操作指南,包含库的安装、指定版本、国内镜像源加速、批量依赖安装、更新检查与安全卸载,并深入解析 python -m pip 与直接调用 pip 的底层区别。
一、前置认知:区分 pip 与 python -m pip 的调用差异
在终端或命令行运行 pip 命令前,必须确保当前系统能够正确识别 pip。通常在安装 Python 解释器时勾选了“Add Python to PATH”即可直接调用。但在多 Python 版本共存或虚拟环境场景下,直接调用 pip 经常引发混淆。
在相同的操作条件下,我们对比两种调用方式的关键机制差异:
- 直接执行
pip install <package>:操作系统会依照环境变量PATH从前到后搜索名为pip的可执行脚本。一旦系统内安装了多个 Python(例如 Python 3.9 与 Python 3.11),终端执行的pip可能会指向另一个版本的目录,导致第三方库被安装到了非预期的解释器路径中。 - 模块化调用
python -m pip install <package>:通过明确指定的python解释器进程加载内置的pip模块。此时被调用的解释器与最终安装第三方库的目标site-packages目录完全严格对应,杜绝了多环境漂移的问题。
因此,在本文及后续日常开发中,推荐优先使用 python -m pip 形式。首先检查当前 Python 与 pip 版本:
终端命令
python -m pip --version
示例输出
pip 24.0 from /usr/local/lib/python3.11/site-packages/pip (python 3.11)
二、安装第三方库:基础语法、版本限定与网络加速
安装第三方库使用 install 子命令。最基础的语法为直接提供包名,例如安装网络请求库 requests:
终端命令
python -m pip install requests
执行后,pip 会连接 PyPI 索引服务器,检索该库的最新稳定版本及其依赖项,下载对应的 Wheel 文件(.whl)或源码包(sdist),并解包安装至当前 Python 环境的 site-packages 目录中。
1. 安装指定版本或限定版本区间
在团队协作或生产部署中,任意安装最新版本可能会引入破坏性更新。pip 允许使用比较运算符精确限定依赖版本:
终端命令
# 精确安装指定版本
python -m pip install "requests==2.31.0"
# 限定兼容版本(大于等于指定版,且小于下一个主版本)
python -m pip install "requests>=2.28.0,<3.0.0"
>、< 等符号具有重定向含义,建议将包含版本限制的包名用双引号包裹,如 "package>=1.0"。
2. 使用国内镜像源加速下载
默认情况下 pip 从海外的 PyPI 官方源下载,可能因网络延迟出现速度慢或 ReadTimeoutError。可以在安装时添加 -i 参数临时切换国内知名高校或服务商的镜像源:
终端命令
# 使用清华大学开源软件镜像站临时安装
python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
3. 依据 requirements.txt 批量安装
在实际项目中,依赖清单通常记录在 requirements.txt 文件中。使用 -r 参数可以一次性批量读取并安装所有依赖:
终端命令
python -m pip install -r requirements.txt
三、检查与更新:管理已安装依赖的版本健康
当项目运行一段时间后,部分库可能发布了安全补丁或新功能。盲目全部更新可能会导致既有代码报错,因此更新操作应遵循“先查询后更新”的原则。
1. 查看已安装库及其元数据
查看当前环境中已经安装的所有第三方库及其版本:
终端命令
python -m pip list
如果需要查看特定某个库的详细信息(包括安装路径、授权协议、所有上游直接依赖项):
终端命令
python -m pip show requests
示例输出
Name: requests
Version: 2.31.0
Summary: Python HTTP for Humans.
Home-page: https://requests.readthedocs.io
Location: /usr/local/lib/python3.11/site-packages
Requires: certifi, charset-normalizer, idna, urllib3
Required-by:
Requires 字段标明了该库运行时所必须的底层依赖,而 Required-by 标明了当前环境中是否有其他库依赖它。这两个字段在后续决定是否更新或卸载时是至关重要的判断依据。
2. 检查哪些库存在可用更新
使用 --outdated 参数可以让 pip 对比本地已装版本与 PyPI 上的最新版本,只列出存在更新的项:
终端命令
python -m pip list --outdated
示例输出
Package Version Latest Type
---------- ------- ------ -----
requests 2.28.1 2.31.0 wheel
urllib3 1.26.12 2.2.1 wheel
3. 执行库的更新操作
通过添加 --upgrade(或简写 -U)参数来更新指定的库:
终端命令
# 更新单个指定的第三方库
python -m pip install --upgrade requests
# 同理,升级 pip 自身也是使用该命令
python -m pip install --upgrade pip
四、卸载第三方库:清理规则与依赖残留分析
当某个库不再使用时,可以使用 uninstall 子命令将其从当前环境中移除。基本的卸载命令如下:
终端命令
python -m pip uninstall requests
在默认交互模式下,终端会列出将要删除的文件路径并暂停等待确认:Proceed (Y/n)?。输入 y 并回车即可完成清理。
1. 免确认自动卸载
如果是在自动化脚本、CI/CD 流程中执行,或者确定无需人工确认,可以加上 -y(或 --yes)参数跳过交互:
终端命令
python -m pip uninstall requests -y
2. 卸载时的“依赖孤岛”残留机制
初学者容易产生一个认知误区:以为执行 pip uninstall requests 会连同其依赖的 urllib3、certifi 等库一并清除。但实际上:
- pip 的卸载设计策略是保守的:
pip uninstall仅仅删除用户指定的该库本身的文件,绝对不会自动递归删除当初为了它而顺带下载的子依赖包。 - 为什么这样设计?因为在复杂的 Python 环境中,底层的
urllib3很可能同时被另外三个库(例如botocore、tweepy)共用。如果 pip 在卸载 requests 时顺带删除了 urllib3,就会立即破坏其他正常运行的库。 - 如何纯净清理?最佳实践是在项目开始时使用独立的 Python 虚拟环境(
venv)。当项目不再需要或依赖混乱时,直接删除整个虚拟环境目录并重新建立,这是最干净、最安全的清理方式。
五、常见问题排查与速查矩阵
在实际操作 pip 时,最常见的三个问题及其精准排查方法如下:
1. 报错 pip: command not found 或非内部或外部命令
原因:操作系统的环境变量 PATH 未包含 Python 根目录下的 Scripts(Windows)或 bin(macOS/Linux)目录。
解决方法:无需紧急修改系统环境变量,直接在终端使用 python -m pip <command>。只要 python 命令有效,即可正常驱动 pip;如果连 python 都找不到,需检查 Python 安装程序是否正确注册。
2. 报错 Permission denied 写入权限不足
原因:在 Linux 或 macOS 系统中,直接向系统级的 Python 目录安装包通常需要管理员权限。切勿轻易使用 sudo pip install,这会污染操作系统的核心 Python 运行时。
解决方法:添加 --user 参数将库安装到当前普通用户的家目录下:
终端命令
python -m pip install --user requests
3. 网络连接超时与 SSL 证书错误
原因:部分内网或代理环境下,连接 PyPI 发生超时或证书拦截。
解决方法:增加超时重试时间,或指定国内可信镜像源:
终端命令
python -m pip install requests --default-timeout=100 -i https://mirrors.aliyun.com/pypi/simple/
总结来说,理解 python -m pip 的解释器直接绑定原理,是避免环境混淆的关键一步。在此基础上,结合 install、list --outdated、--upgrade 与 uninstall 的规范参数,即可高效、可控地维护 Python 第三方库生态。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













