在Visual Studio Code中导入Python的MySQL Connector遇ModuleNotFoundError的解决方法

数据老陈

2026-7-30

解决ModuleNotFoundError: No module named 'mysql.connnector'的方案

检查导入拼写
错误提示里的mysql.connnector多了一个字母n，正确的模块名是mysql.connector，确保代码里的导入语句为：
```
import mysql.connector
```
安装MySQL Connector/Python模块
若拼写无误，说明模块未安装到当前使用的Python环境，执行对应安装命令：
- 常规pip安装：
```
pip install mysql-connector-python
```
- 多Python版本环境用pip3：
```
pip3 install mysql-connector-python
```
- 虚拟环境需先激活环境，再执行上述命令。
匹配VS Code的Python环境
VS Code可能使用了与终端不同的Python解释器，导致模块装错环境：
- 点击VS Code左下角的Python版本标识，切换到你安装模块的那个环境（如虚拟环境、系统Python3.x）
- 或者在VS Code终端中，用which python（Mac/Linux）或where python（Windows）确认当前Python路径，再重新安装模块。
验证安装结果
在VS Code终端运行以下命令，测试模块是否可正常导入：
```
python -c "import mysql.connector; print('模块安装成功')"
```
若输出“模块安装成功”，回到代码重新运行即可。