Python pip使用教程:怎么安装、更新与卸载第三方库

Cora
Cora
发布时间:2026-11-21 | 2人浏览过
原创

系统讲解 Python 官方包管理工具 pip 的实用操作指南,包含库的安装、指定版本、国内镜像源加速、批量依赖安装、更新检查与安全卸载,并深入解析 python -m pip 与直接调用 pip 的底层区别。

pip 是 Python 官方推荐的包管理工具,用于从 Python Package Index (PyPI) 下载并安装第三方扩展库。掌握第三方库的安装、更新与卸载,是搭建开发环境与维护项目依赖的基本功。本文从可执行环境识别出发,完整演示核心操作步骤、常用参数与避坑要点。

一、前置认知:区分 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 pip使用教程:怎么安装、更新与卸载第三方库
图 1:直接调用 pip 与通过 python -m pip 模块调用的环境绑定差异

因此,在本文及后续日常开发中,推荐优先使用 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"
提示:在 macOS 或 Linux 的 zsh 终端中,>、< 等符号具有重定向含义,建议将包含版本限制的包名用双引号包裹,如 "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
Python pip使用教程:怎么安装、更新与卸载第三方库
图 2:从用户发起安装命令到库就绪的五步处理机制

三、检查与更新:管理已安装依赖的版本健康

当项目运行一段时间后,部分库可能发布了安全补丁或新功能。盲目全部更新可能会导致既有代码报错,因此更新操作应遵循“先查询后更新”的原则。

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
Python pip使用教程:怎么安装、更新与卸载第三方库
图 3:依赖更新前的评估路径与安全升级策略

四、卸载第三方库:清理规则与依赖残留分析

当某个库不再使用时,可以使用 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 pip使用教程:怎么安装、更新与卸载第三方库
图 4:pip 核心命令矩阵与常见操作速查卡片

总结来说,理解 python -m pip 的解释器直接绑定原理,是避免环境混淆的关键一步。在此基础上,结合 install、list --outdated、--upgrade 与 uninstall 的规范参数,即可高效、可控地维护 Python 第三方库生态。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表