Windows 安装 Python 模块教程：从零到会，几分钟搞定

目标关键词：Windows 安装 Python 模块

在 Windows 上安装 Python 模块，其实就是把你需要的功能包装进 Python 环境里。很多人第一次装模块会遇到这些情况：命令输不对、多个 Python 版本冲突、提示找不到 pip、安装后还是无法导入、权限不足、国内网络下载慢。
这篇文章就围绕 Windows 安装 Python 模块 这件事，按新手也能看懂的方式，讲清楚怎么装、怎么检查、怎么排错、怎么避免踩坑。

---

一、先搞明白：什么是 Python 模块

Python 模块，简单理解就是“现成的功能包”。

比如：

• requests：用来发网络请求
• pandas：处理表格数据
• numpy：做数学计算
• pillow：处理图片
• selenium：自动化操作网页

你不用自己从头写，直接安装模块就能用。

在 Windows 上安装模块，最常见的方式就是用 pip。

---

二、安装前先检查这 3 件事

很多安装失败，不是模块本身的问题，而是前期环境没准备好。

1. 确认电脑已经安装 Python

按下 Win + R，输入：

cmd

回车打开命令提示符，然后输入：

python --version

或者：

py --version

如果能显示版本号，比如：

Python 3.12.1

说明 Python 已经装好了。

---

2. 确认 pip 是否可用

继续输入：

pip --version

如果返回类似：

pip 24.0 from ...

说明 pip 正常，可以直接安装模块。

如果提示“不是内部或外部命令”，通常是环境变量没配好，后面会讲解决方法。

---

3. 确认你装的是哪个 Python

Windows 上经常会装多个 Python 版本，比如：

• 系统里一个 Python 3.10
• 你又装了 Python 3.12
• 某些软件自带一个 Python

这会导致你明明装了模块，运行程序时却提示：

ModuleNotFoundError: No module named xxx

核心原因往往就是：模块装到了 A 版本，但程序用的是 B 版本。

---

三、最常用的安装方法：用 pip 安装

这是 Windows 安装 Python 模块最标准、最常见的方法。

1. 打开命令提示符

按：

• Win + R
• 输入 cmd
• 回车

---

2. 输入安装命令

格式是：

pip install 模块名

比如安装 requests：

pip install requests

安装 pandas：

pip install pandas

安装 numpy：

pip install numpy

---

3. 等待安装完成

如果成功，通常会看到类似：

Successfully installed requests-2.32.3

这就表示安装好了。

---

四、推荐更稳的安装方式：用 Python 自带方式调用 pip

比起直接输入 pip install，我更推荐你用这个方法，尤其是 Windows 上有多个 Python 版本时：

python -m pip install 模块名

例如：

python -m pip install requests

这个方式的好处是：

• 更准确
• 不容易装错环境
• 更适合排查问题

如果你的系统里 python 命令不稳定，也可以试试：

py -m pip install requests

---

五、如果安装速度很慢，换国内镜像源

Windows 用户安装 Python 模块时，最常见的痛点就是：下载慢、超时、失败。
这时可以改用国内镜像源。

临时使用镜像源

比如使用清华源：

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

安装 pandas：

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

---

永久设置镜像源

如果你经常装模块，建议直接配置成默认镜像。

方法 1：命令行设置

输入：

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

设置完成后，以后直接：

pip install requests

也会走这个源。

方法 2：手动配置文件

在以下路径创建或修改配置：

C:\Users\你的用户名\pip\pip.ini

写入内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

---

六、安装到指定 Python 版本的方法

如果你电脑上有多个 Python 版本，强烈建议指定版本安装。

查看系统里有哪些 Python

输入：

py -0

可能返回：

 -3.12
 -3.10

表示系统里有两个版本。

---

给指定版本安装模块

比如要给 Python 3.12 安装 requests：

py -3.12 -m pip install requests

给 Python 3.10 安装：

py -3.10 -m pip install requests

这个方法非常实用，能避免“装了却用不了”的问题。

---

七、虚拟环境里安装模块：更适合项目开发

如果你在做 Python 项目，建议用 虚拟环境。
这样每个项目的模块互不影响，不会把系统环境弄乱。

1. 创建虚拟环境

进入你的项目目录后，输入：

python -m venv venv

这会在当前目录创建一个 venv 文件夹。

---

2. 激活虚拟环境

在 Windows 的 CMD 里输入：

venv\Scripts\activate

如果成功，命令行前面会出现：

(venv)

---

3. 在虚拟环境里安装模块

pip install requests

这时模块只会装到当前项目的虚拟环境中。

---

4. 退出虚拟环境

输入：

deactivate

---

八、安装后怎么确认模块装成功了

安装完成后，可以做一个简单检查。

方法 1：查看已安装列表

输入：

pip list

你会看到当前环境已安装的模块。

---

方法 2：直接导入测试

打开 Python：

python

然后输入：

import requests
print(requests.__version__)

如果没有报错，说明安装成功。

如果报错：

ModuleNotFoundError

说明模块没有装在当前运行环境里。

---

九、常见报错与解决方法

这是 Windows 安装 Python 模块时最关键的部分。

---

1. 报错：'pip' 不是内部或外部命令

问题分析

通常是这几种原因：

• Python 没装好
• pip 没加入环境变量
• 你装了 Python，但安装时没勾选“Add Python to PATH”

解决方法

先试：

python -m pip install 模块名

如果可以用，说明只是 pip 命令没直接生效。

如果 python 也不行，说明环境变量有问题，需要重新配置。

---

2. 报错：ModuleNotFoundError: No module named xxx

问题分析

模块装了，但运行程序时找不到，通常是 Python 环境不一致。

解决方法

先查当前 Python 路径：

where python

再查 pip 对应的路径：

python -m pip --version

确认你安装模块和运行程序是不是同一个 Python。

建议直接用：

python -m pip install 模块名

或：

py -3.12 -m pip install 模块名

---

3. 报错：Permission denied 或权限不足

问题分析

你没有权限往系统目录写入模块。

解决方法

优先用用户模式安装：

pip install 模块名 --user

例如：

pip install requests --user

如果是开发项目，更推荐使用虚拟环境。

---

4. 报错：下载超时、连接失败

问题分析

网络慢、源访问不稳定、被防火墙拦截。

解决方法

改用国内镜像源：

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

如果还是不行，检查：

• 是否开了代理
• 是否被安全软件拦截
• 公司网络是否限制外网访问

---

5. 报错：No matching distribution found

问题分析

常见原因：

• 模块名写错
• Python 版本太低
• 模块不支持你的系统或版本

解决方法

先确认模块名拼写是否正确。
再检查 Python 版本：

python --version

有些新模块要求 Python 3.8、3.9 以上，版本太低就装不上。

---

十、Windows 上安装模块的推荐操作顺序

如果你是新手，照着下面做最稳：

第一步：打开 CMD

按 Win + R，输入 cmd，回车。

第二步：查看 Python 版本

输入：

python --version

第三步：使用推荐命令安装

输入：

python -m pip install requests

第四步：如果很慢，加镜像源

输入：

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

第五步：验证安装结果

输入：

python

进入后执行：

import requests

不报错就说明成功。

---

十一、适合新手的最简版操作

如果你只想快速搞定，可以直接记住这几句：

安装模块

python -m pip install 模块名

带国内镜像源安装

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

查看已安装模块

pip list

测试导入

python

然后输入：

import 模块名

---

十二、进阶用户建议：用 requirements.txt 批量安装

如果你做项目，经常需要一次装很多模块，可以把依赖写进 requirements.txt。

文件内容示例：

requests
pandas
numpy
pillow

然后执行：

pip install -r requirements.txt

这在项目部署、换电脑、重装系统时特别方便。

---

十三、卸载模块的方法

装错了模块，或者不想用了，可以卸载。

pip uninstall 模块名

例如：

pip uninstall requests

然后按提示输入 y 确认即可。

---

十四、安装模块时的实用避坑技巧

1. 尽量不要乱用系统自带 Python

Windows 上最好明确知道自己在用哪一个 Python。
多个版本混着用，最容易出问题。

2. 新手优先用 python -m pip

这个方式最稳，不容易装错环境。

3. 做项目尽量用虚拟环境

避免不同项目之间模块冲突。

4. 不要随便从来路不明的网站下载 .whl

如果不是特别清楚来源，尽量直接用 pip 安装，安全性更高。

5. 如果是公司电脑，注意权限和网络限制

有些单位电脑会限制外网下载，镜像源和代理设置都可能受影响。

---

十五、总结：Windows 安装 Python 模块最稳的方法

Windows 安装 Python 模块，最推荐的思路是：

1. 先确认 Python 正常
2. 用 python -m pip install 模块名 安装
3. 网络慢就加国内镜像源
4. 多版本 Python 就指定版本安装
5. 项目开发就用虚拟环境
6. 安装后用 import 测试是否成功

如果你是小白，直接记住这一条就够了：

python -m pip install requests

需要更快就加镜像：

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

只要命令正确、环境对应、网络正常，Windows 上安装 Python 模块其实并不复杂。