Windows10怎么安装 PyMySQL？从下载安装到验证使用，一篇讲明白

目标关键词：Windows10怎么安装PyMySQL

如果你是刚接触 Python 的新手，第一次听到 PyMySQL，可以先把它理解成一个“连接工具”：
它能让 Python 程序去连接 MySQL 数据库，然后完成增删改查等操作。
在 Windows 10 上安装 PyMySQL 并不复杂，真正容易出问题的地方通常不是安装本身，而是 Python 环境没配好、pIP 用错了、模块装到了别的环境里。

下面就按“问题分析 → 解决方案 → 注意事项”的思路，带你一步一步装好，并教你怎么确认安装成功。

---

一、问题分析：为什么很多人安装 PyMySQL 会失败？

很多新手以为“安装 PyMySQL”就是点一下就行，结果最后报错，常见原因有这几个：

1. Python 没装好，或者没加到环境变量

如果电脑里根本没有 Python，或者装了但命令行里无法识别 python、pip，那后面的安装自然也做不了。

2. pip 装错环境

有的人电脑里有多个 Python，比如：

• 系统里一个 Python
• Anaconda 里一个 Python
• PyCharm 里又选了另一个解释器

结果是：你明明安装了 PyMySQL，但运行时还是提示：

ModuleNotFoundError: No module named 'pymysql'

这通常就是“装到别的环境去了”。

3. 网络问题或 pip 版本太旧

如果国内网络不稳定，直接从国外源下载，有时会慢、超时，甚至失败。

4. 文件名冲突

如果你自己的项目里刚好有个文件叫：

pymysql.py

Python 可能会误以为你在导入这个文件，而不是安装好的第三方库。

---

二、解决方案：Windows10 安装 PyMySQL 的完整步骤

---

第一步：先确认电脑有没有安装 Python

按下面方法检查：

方法一：命令行检查

1. 按下 Win + R
2. 输入 cmd
3. 回车打开命令提示符
4. 输入：

python --version

如果显示类似：

Python 3.10.8

说明 Python 已安装。

如果提示不是内部或外部命令，说明系统没识别到 Python。

你还可以再输入：

pip --version

如果能看到 pip 版本，说明 pip 也可用。

---

第二步：如果没有 Python，先安装 Python

安装方法

1. 打开 Python 官方网站
2. 下载 Windows 版本安装包
3. 安装时一定勾选：
   • Add Python to PATH
4. 点击安装

为什么一定要勾选“Add Python to PATH”？

因为这样你才能在命令行里直接使用 python 和 pip 命令。
不勾选的话，后面安装和运行会很麻烦。

安装后再验证

重新打开命令提示符，输入：

python --version
pip --version

都能正常显示就说明没问题。

---

第三步：使用 pip 安装 PyMySQL

这是最核心的一步。

基本安装命令

打开命令提示符，输入：

pip install pymysql

如果安装成功，通常会看到类似提示：

Successfully installed PyMySQL-1.1.0

这就说明安装完成了。

---

三、推荐安装方式：更稳的做法

如果你是新手，建议直接用下面这种方式，避免装错环境。

方式一：用 Python 自带方式安装

比起单独写 pip install pymysql，更稳妥的是：

python -m pip install pymysql

这个命令的好处是：

• 会明确使用当前 Python 对应的 pip
• 不容易装到别的环境里
• 适合多版本 Python 用户

如果你的电脑里有多个 Python，这个方式尤其推荐。

---

方式二：使用国内镜像源，加快下载速度

如果你发现安装慢、卡住、超时，可以换国内源，比如清华源：

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

或者：

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

这种方式对国内网络环境更友好，下载速度通常更快。

---

四、安装完成后，怎么确认 PyMySQL 已经能用？

安装完别急着关，建议马上验证。

方法一：查看是否安装成功

在命令行输入：

pip show pymysql

如果输出类似下面这些内容，说明已经安装成功：

Name: PyMySQL
Version: 1.1.0
Summary: Pure Python MySQL Client
Location: ...

方法二：进入 Python 测试导入

先输入：

python

进入 Python 交互环境后，再输入：

import pymysql
print(pymysql.__version__)

如果没有报错，并且打印出版本号，说明安装和导入都正常。

如果报错：

ModuleNotFoundError: No module named 'pymysql'

说明当前 Python 环境里没有这个包，或者你装到了别的环境中。

---

五、PyCharm 里怎么安装 PyMySQL？

很多人是用 PyCharm 写 Python 程序，不是直接在命令行里开发。
如果你是这种情况，安装方式也很简单。

方法一：在 PyCharm 终端安装

打开 PyCharm，进入底部的 Terminal，输入：

pip install pymysql

或者更稳妥一点：

python -m pip install pymysql

方法二：在项目解释器里安装

1. 打开 PyCharm
2. 进入 Settings
3. 找到 Project → Python Interpreter
4. 点击右侧的 +
5. 搜索 pymysql
6. 点击安装

这种方式适合不熟悉命令行的人，但有时候会因为解释器选错，导致看起来装了，实际项目里用不了。

---

六、安装后如何连接 MySQL？简单示例

安装 PyMySQL 不是目的，关键是让它真正连上数据库。
下面给你一个最基础的测试代码。

import pymysql

conn = pymysql.connect(
    host='127.0.0.1',
    user='root',
    password='你的数据库密码',
    database='test',
    charset='utf8mb4'
)

cursor = conn.cursor()
cursor.execute("SELECT VERSION()")
result = cursor.fetchone()
print(result)

cursor.close()
conn.close()

代码说明

• host='127.0.0.1'：本机数据库
• user='root'：数据库用户名
• password='你的数据库密码'：数据库密码
• database='test'：你要连接的库名
• charset='utf8mb4'：避免中文乱码，建议保留

如果输出了 MySQL 版本号，说明 PyMySQL 已经可以正常工作了。

---

七、常见报错和解决办法

---

1. ModuleNotFoundError: No module named 'pymysql'

原因

当前运行代码的 Python 环境没有安装 PyMySQL。

解决办法

先确认你执行安装命令时用的是哪个 Python：

python -m pip install pymysql

然后再确认当前运行代码的解释器是否一致。

如果你在 PyCharm 里运行，重点检查：

• 项目解释器是不是同一个 Python
• 终端安装和运行是否在同一环境

---

2. pip 不是内部或外部命令

原因

Python 没加环境变量，或者没安装成功。

解决办法

先检查：

python --version

如果可以用，但 pip 不行，可以试：

python -m pip install pymysql

如果 python 也不行，先重新安装 Python，并勾选 Add Python to PATH。

---

3. 下载超时或卡住

原因

网络连接慢，或者默认源访问不稳定。

解决办法

换镜像源：

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

---

4. 导入后还是报错

原因

项目里文件命名冲突。

解决办法

检查你的项目目录里有没有这些文件名：

• pymysql.py
• pymysql.pyc
• __pycache__

如果有，改名后重新运行。

---

八、进阶用户建议：用虚拟环境安装更规范

如果你以后会学更多 Python 项目，建议你养成使用虚拟环境的习惯。
这样每个项目的依赖互不影响，不容易乱。

创建虚拟环境

进入项目目录后执行：

python -m venv venv

激活虚拟环境

Windows 10 下执行：

venv\Scripts\activate

激活成功后，命令行前面一般会出现 (venv)。

在虚拟环境中安装 PyMySQL

pip install pymysql

这样安装的包只作用于当前项目，后期维护更省心。

---

九、最稳妥的安装总结

如果你只想快速装好，直接记住这套就行：

一步到位命令

python -m pip install pymysql

如果下载慢

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

验证是否成功

python

然后输入：

import pymysql
print(pymysql.__version__)

只要不报错，就说明安装完成。

---

十、安装 PyMySQL 的注意事项

1. 不要把安装命令和 Python 代码混在一起

pip install pymysql 是在命令行里执行的，不是在 .py 文件里执行的。

2. 尽量统一环境

安装、运行、调试尽量都用同一个 Python 解释器，避免“装了但不能用”的情况。

3. 数据库连接密码不要乱写

写代码测试时，数据库账号、密码、库名要正确。
PyMySQL 安装成功，不代表数据库一定能连上，连接失败也可能是 MySQL 服务没启动、密码错误、端口不对。

4. 中文编码建议用 utf8mb4

这样更稳，避免中文插入数据库时报乱码。

---

十一、适合新手的最终操作清单

你可以直接照着做：

1. 安装 Python，并勾选 Add Python to PATH
2. 打开命令提示符
3. 输入：

   python -m pip install pymysql

4. 如果慢，加镜像源：

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

5. 验证安装：

   python

   然后输入：

   import pymysql
   print(pymysql.__version__)

6. 没报错就可以开始写数据库连接代码了

---

十二、结语式总结

Windows10 安装 PyMySQL 其实很简单，关键不在“装包”本身，而在于你是否把 Python 环境、pip、项目解释器 这三件事对齐了。
只要你按正确的环境安装，基本不会出什么大问题。最推荐的方式就是：

python -m pip install pymysql

这条命令简单、稳定、适合大多数 Windows 10 用户。