《Python 从入门到精通》142|pip 的正确用法:安装、升级、卸载与镜像源

一、学第三方库，第一步绕不开 pip

上一章我们讲了第三方库为什么重要。 那接下来最现实的问题就是：

这些库怎么装进你的 Python 环境里。

这时候，几乎每个 Python 学习者都会接触到一个词：pip

很多人第一次看到它，只会机械地敲一条命令：

pip install requests

库装上了，好像就结束了。

但真正开始做项目后，你很快就会发现，光会这一句远远不够。 你还会碰到这些情况：

安装失败 版本不对 升级后代码跑不起来 库名和导入名对不上 下载很慢 卸载不干净 明明装过却提示找不到模块 不同项目需要不同版本

这些问题，本质上都和 pip 的使用习惯有关。

所以这一章的目标不是教你背几条命令，而是让你真正把 pip 这件事用明白。 它不是一句安装命令，而是你管理 Python 第三方库最基础的工具。

二、pip 到底是什么

pip 是 Python 最常用的包管理工具。

你可以把它理解成：

专门用来安装、升级、卸载、查询 Python 第三方库的软件管家。

这里的“包”，通常就是我们平时说的第三方库。 比如：

requestspandasflasknumpy

它们都可以通过 pip 来安装和管理。

所以 pip 做的事情，本质上有点像手机里的应用商店加上应用管理器：

帮你下载 帮你安装 帮你更新 帮你删除 帮你查看版本

只不过它管的不是手机 App，而是 Python 运行环境里的各种库。

三、先确认你的 pip 能不能正常用

很多初学者一上来就输入安装命令，结果报错：

找不到 pip 命令无法识别 权限不足 环境不对

所以第一步不是直接安装库，而是先确认 pip 本身可用。

最常见的检查方式：

pip --version

或者：

pip -V

如果正常，你会看到类似输出：

pip 25.x from ... (python 3.x)

这行信息至少说明了两件事：

第一，pip 命令能用。 第二，它正在服务哪个 Python 版本。

这一步非常重要。 因为后面很多“明明装了却用不了”的问题，根源就是你以为自己给当前 Python 装了库，实际上装到别的解释器环境里去了。

四、为什么很多时候更推荐用 python -m pip

这是一条非常实用的经验。

很多教程直接写：

pip install requests

这当然常见，也经常能用。 但更稳妥的写法通常是：

python -m pip install requests

如果你电脑上有多个 Python 版本，甚至会写成：

python3 -m pip install requests

为什么这样更稳。

因为这句话的意思其实是：

用当前这个 Python 解释器去调用它对应的 pip。

这样能大大减少“pip 和 python 不是同一个环境”的问题。

你可以这样理解：

pip install ...更像是直接找系统里那个叫 pip 的工具来干活。

python -m pip install ...更像是明确告诉当前 Python：你自己去调用你那套 pip。

在多版本 Python、虚拟环境、不同 IDE 混用的场景下，第二种方式通常更可靠。

所以从习惯上说，建议你慢慢优先使用：

python -m pip ...

这会帮你减少很多环境混乱问题。

五、最基础的安装命令怎么写

安装一个第三方库，最常见就是：

pip install 库名

比如安装 requests：

pip install requests

如果你用更稳的写法：

python -m pip install requests

两者本质目标一样，都是把 requests 装进当前 Python 环境。

安装完成后，一般终端里会显示：

成功下载 成功安装 依赖项处理完成

然后你就可以在代码里导入它：

import requests

注意一个容易踩坑的点：

安装时的库名，和导入时的模块名，大多数时候一样，但不是永远一样。 比如有些包安装名和导入名会有差异，所以不要想当然全部画等号。

不过入门阶段常见库通常比较一致。

六、安装指定版本，是项目里非常常见的需求

初学时大家一般默认装最新版。 但一旦做项目，你很快会发现，版本非常关键。

比如某个教程是基于某个旧版写的。 某个库新版本改了 API。 某个项目依赖固定版本。 某个功能在高版本里行为变了。

这时候就不能只会“装最新版”，还得会装指定版本。

语法是：

pip install 库名==版本号

比如：

pip install requests==2.31.0

这表示只安装这个具体版本。

你还可以写版本范围：

pip install "requests>=2.28,<3.0"

这表示安装一个满足范围要求的版本。

入门阶段你至少要先记住最常见的这个：

pip install 包名==版本号

因为未来你看项目文档、教程、依赖说明时，经常会碰到这种写法。

七、升级库怎么做

很多人装完库后，就忽略了升级这件事。 但实际中，升级库是很常见的动作。

比如：

你想用新版功能 旧版有 Bug 新环境需要统一版本 某个安全问题在新版本中修复了

升级命令通常是：

pip install --upgrade 库名

或者简写：

pip install -U 库名

比如：

pip install --upgrade requests

更稳一点的写法仍然可以是：

python -m pip install --upgrade requests

它的含义很明确：

如果没装，就安装。 如果装了旧版，就升级到可获取的新版本。

这也是为什么很多人把 install 理解成“安装专用命令”其实不够准确。 它既可以装，也可以配合参数完成升级。

八、升级前要知道，升级不一定总是好事

这件事必须提醒你。

很多初学者会有一种直觉：

新版本肯定更好，所以一律升级就对了。

现实里没这么简单。

新版本可能确实修了问题、加了功能。 但它也可能：

修改了函数行为 废弃了旧接口 改变了依赖关系 导致你原来的代码不兼容

尤其在项目开发中，盲目升级有时反而会引发问题。

所以正确的态度是：

个人练习时，升级通常问题不大。 正式项目里，升级前要看版本说明、依赖要求、兼容情况。

这也是为什么后面学虚拟环境和依赖管理会那么重要。 因为版本控制，本来就是项目管理的一部分。

九、卸载库怎么做

既然能装、能升，那自然也能删。

卸载命令：

pip uninstall 库名

比如：

pip uninstall requests

系统通常会提示你确认，输入 y 后才会真正删除。

如果你想跳过确认，也可以这样：

pip uninstall -y requests

这个在批处理场景里很方便，但平时手动操作时，确认一下通常更稳。

卸载最常见的用途有几个：

装错库了 版本冲突 环境污染 想重新安装 项目不再需要这个依赖

很多“奇怪问题”有时就是靠先卸载，再重装解决的。

十、怎么查看已经安装了哪些库

当环境里库越来越多时，你不可能全靠脑子记。 这时候就需要查询命令。

最常见的是：

pip list

它会列出当前环境安装的库和版本。

比如你会看到：

Package    Versionrequests   2.31.0numpy      1.26.xpandas     2.x.x

这个命令非常实用，适合做这些事：

确认某个库有没有装 确认当前版本 看看环境里都有哪些依赖

另外还有一个很常见的命令：

pip freeze

它和 pip list 看起来有点像，但用途更偏项目依赖导出。 输出通常更适合写入依赖文件，比如：

requests==2.31.0pandas==2.2.0numpy==1.26.4

后面讲 requirements.txt 时，它会特别重要。

你现在先有个印象就行：

pip list 更像给人看。pip freeze 更像给项目依赖记录用。

十一、怎么查看某个库的详细信息

如果你想看某个包更具体的信息，可以用：

pip show 库名

比如：

pip show requests

你会看到一些信息，比如：

版本 安装位置 依赖项 包简介

这在排查问题时非常有用。

比如你想知道：

这个库到底装到哪里去了 当前版本是多少 它依赖了哪些别的库

这时候 pip show 会比 pip list 更细。

尤其是“安装位置”这项，排查环境问题时很有帮助。 有时候你会发现库确实装了，但装在你没用的那个 Python 环境里。

十二、镜像源为什么会成为高频问题

学到这里，很多人会遇到一个很现实的问题：

命令明明没错，可就是装得很慢，甚至失败。

为什么。

因为 pip 默认通常是从官方仓库拉取包。 网络环境不稳定时，下载速度可能很一般，甚至会超时。

这时候就会接触到一个关键词：

镜像源

你可以把镜像源理解成：

官方包仓库的一个加速访问入口，内容同步，但访问路径更适合当前网络环境。

它不是“另一个库”，而是“另一个下载站点入口”。

所以镜像源的核心价值只有一个：

让下载更快、更稳定。

十三、临时使用镜像源怎么写

最常见的写法是：

pip install 包名 -i 镜像地址

比如：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

这条命令表示：

安装 requests，但这次下载时不要走默认源，而是走指定镜像源。

你也可以写成：

python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

这在网络环境一般、官方源下载不顺时特别实用。

你可以把这种方式理解成“临时换路”。 只对当前这一条命令生效。

十四、为什么镜像地址后面经常带 /simple

很多人第一次看到镜像源地址，都会疑惑最后那个 /simple 是什么。

你现在不用深究仓库协议细节，只要记住：

很多 pip 镜像地址都需要带上 /simple 这个路径，才能被 pip 正常识别为包索引入口。

所以看到这种写法，不要觉得奇怪：

https://pypi.tuna.tsinghua.edu.cn/simple

它不是随便拼的，而是常见规范格式。

入门阶段先会用就够了。

十五、怎么把镜像源设成默认

如果你每次都手写 -i 镜像地址，时间一长会觉得麻烦。 这时候就可以考虑配置默认镜像源。

不同系统的配置方式略有差异，但思路是一样的： 通过 pip 配置文件，把默认索引地址改掉。

另一种比较直观的方式，是直接用命令配置：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

配置完成后，后续很多安装命令就不用每次都手动加 -i 了。

如果想查看当前配置，可以用：

pip config list

如果以后想改回来，也可以重新设置。

这里你先记住两件事：

临时用镜像：命令后加 -i长期默认用镜像：配置 global.index-url

这已经足够应对大多数入门到实战场景。

十六、为什么有时候安装失败，不一定是 pip 的问题

很多人一装失败，就会说：

pip 坏了。

其实很多时候不是。

常见失败原因包括：

网络不通 镜像源访问不稳定 Python 版本不兼容 库本身不支持当前系统 权限不足 环境混乱 依赖冲突 包名写错 把导入名当成安装名

所以碰到安装问题时，不要只盯着错误结果，要学会拆原因。

比如先看这些：

网络正常吗 是否换镜像后能装 Python 版本是否太新或太旧 包名是否拼错 当前环境是不是目标环境 有没有权限问题

把问题拆开后，很多错误并没有那么神秘。

十七、最容易混淆的一个点：包名和导入名不一定一样

这一点很值得单独说。

很多人会下意识觉得：

我代码里 import xxx，那安装时一定是 pip install xxx

多数时候确实如此，但不是总这样。

有些包安装名和导入名不同。 有些安装名里带连字符，导入时却用下划线或别的名字。 有些是一个大包里带多个模块。

所以当你遇到“我明明装了，为什么导入报错”时，除了检查环境，也要考虑是否装错了包名。

入门阶段虽然不用背太多例子，但一定要有这个意识：

安装名和导入名，大多数时候一致，但不能百分百想当然。

十八、权限问题怎么理解

有时候你安装库时会遇到权限错误，比如没有写入权限。 常见原因是你正在往系统级 Python 目录里装库，而当前用户权限不够。

这时常见做法有几种：

切换到虚拟环境里安装 使用用户级安装 以管理员权限运行终端 检查当前 Python 安装方式

其中，最推荐的长期做法，其实不是乱加权限，而是：

尽量在虚拟环境里装项目依赖

因为这样最干净，也最少出环境问题。 下一章讲虚拟环境时，你会对这个问题一下子更有感觉。

有时你也会看到有人用：

pip install --user 包名

这表示装到当前用户目录，不走系统全局目录。 它在一些权限受限环境里会有帮助，但项目开发里，虚拟环境通常更规范。

十九、升级 pip 本身也很常见

很多安装问题，并不一定是库的问题，也可能是 pip 自己版本太老。

升级 pip 的常见命令：

python -m pip install --upgrade pip

或者：

python -m pip install -U pip

这条命令很常见，尤其是在新装 Python 后，或者某些依赖安装异常时。

不过升级 pip 时，也要注意你正在升级的是哪个 Python 环境对应的 pip。 所以还是那句话，优先用：

python -m pip ...

比单独写 pip ... 更稳。

二十、一个项目里最实用的几条 pip 命令，最好先记熟

如果你现在只想先抓住最常用的部分，可以先把下面几条记住。

检查版本：

python -m pip --version

安装库：

python -m pip install requests

安装指定版本：

python -m pip install requests==2.31.0

升级库：

python -m pip install --upgrade requests

卸载库：

python -m pip uninstall requests

查看已安装库：

python -m pip list

查看包详情：

python -m pip show requests

使用镜像安装：

python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

你把这几条用熟，已经能覆盖大部分日常场景。

二十一、实际开发里，pip 不只是装库，更是在管理环境

这句话很重要。

很多初学者把 pip 理解成“装个库的小工具”。 但到了项目阶段，它其实承担的是依赖管理入口的角色。

你项目能不能跑，往往跟这些强相关：

库版本对不对 环境是不是同一套 依赖有没有装齐 某个包有没有升级过头 旧包有没有冲突 机器之间环境能不能复现

所以 pip 不是一个一次性工具，而是你日后做项目时要反复使用的基础设施。

你现在学的是安装、升级、卸载、镜像。 后面很快就会接到：

虚拟环境 依赖文件 环境复现 项目打包

这些东西都和 pip 密切相关。

二十二、新手最常见的几个坑

1. 只会 pip install，不会检查环境

结果库装到了另一个 Python 里，当前代码却导不进来。

2. 用 pip 命令时没搞清对应哪个解释器

所以更推荐 python -m pip。

3. 盲目升级所有包

结果旧项目直接跑挂。

4. 装库很慢却不知道用镜像源

其实很多下载问题换个镜像就能改善很多。

5. 看到模块报错就一直重装

有时候根本不是没装，而是环境切错了。

6. 把包名和导入名完全等同

多数时候行，但不是永远成立。

7. 在系统全局环境里乱装一堆包

最后环境越用越乱，排查非常痛苦。

这些问题你现在就有意识，后面会少踩很多坑。

二十三、本章要点整理

pip 是 Python 最常用的第三方库管理工具。 它负责安装、升级、卸载、查看和管理包。 更稳妥的使用方式通常是 python -m pip ...，这样更容易和当前解释器绑定。 安装库用 pip install 包名。 安装指定版本用 pip install 包名==版本号。 升级库用 pip install --upgrade 包名。 卸载库用 pip uninstall 包名。 查看已安装包可用 pip list，查看详细信息可用 pip show 包名。 下载慢时可以通过 -i 指定镜像源，也可以配置默认镜像。 很多安装问题并不是 pip 本身坏了，而是网络、权限、环境、版本、依赖等问题。 学会正确使用 pip，本质上是在为后续项目依赖管理打基础。