ModuleNotFoundError: No module named 'mysql'问题求助（M1+XAMPP8.0）

云原生阿岚

2026-8-16

解决ModuleNotFoundError: No module named 'mysql'问题

针对你在M1芯片设备、XAMPP 8.0.0环境下遇到的这个错误，按以下步骤排查解决：

确认Python环境一致性
M1设备可能同时存在多个Python版本（系统原生、Rosetta兼容、XAMPP自带等），pip3安装的包可能不在当前运行代码的Python环境中。执行以下命令验证：
```
# 查看当前运行的Python3路径
which python3
# 查看该Python环境已安装的包
python3 -m pip list
```
检查输出中是否有mysql-connector-python，如果没有，说明安装的包不在当前使用的环境里。
安装官方标准的MySQL连接器包
你安装的mysql和mysql-connector并非官方推荐的连接器包，官方标准包为mysql-connector-python。先卸载旧包，再安装正确版本：
```
pip3 uninstall mysql mysql-connector
python3 -m pip install mysql-connector-python
```
如果M1原生环境安装失败，右键打开终端选择「使用Rosetta打开」，再执行上述安装命令。
适配XAMPP自带Python环境
若你使用XAMPP内置的Python运行代码，需要给该环境单独安装包：
```
/Applications/XAMPP/xamppfiles/bin/python3 -m pip install mysql-connector-python
```
请将路径替换为你实际的XAMPP Python安装路径。