mysql-connector-python在Python shell可运行但VS Code报错无法使用

• 解释器环境不匹配：Python shell使用的解释器和VS Code当前项目绑定的Python解释器不属于同一个环境，mysql-connector-python仅安装到了shell对应的解释器依赖目录下，VS Code使用的解释器环境中没有对应安装包。
• 本地文件命名冲突：如果项目目录下存在名为mysql.py的脚本文件，或者名为mysql的文件夹，Python导入模块时会优先加载本地的同名文件/文件夹，不会读取官方安装的mysql包，进而触发报错。
• 虚拟环境未正确适配：如果依赖包安装在虚拟环境中，但VS Code没有切换到对应虚拟环境的解释器，也会出现找不到模块的问题。

1. 切换VS Code Python解释器 #

• 打开VS Code命令面板，快捷键为Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter选项。
• 你可以先在可正常运行的Python shell中执行import sys; print(sys.executable)获取对应解释器的绝对路径，在VS Code的解释器列表中选中该路径对应的选项即可。
• 切换完成后重启VS Code终端，执行pip list确认mysql-connector-python出现在已安装依赖列表中。

2. 排查命名冲突 #

• 检查项目根目录、当前运行脚本所在目录下是否存在mysql.py文件或mysql文件夹，如有则将其重命名为其他不冲突的名称（如mysql_demo.py），同时删除同目录下的__pycache__缓存文件夹后重新运行脚本。

3. 强制重装依赖 #

确认解释器匹配后，直接在VS Code当前项目的终端中执行命令强制重装依赖：

pip install --force-reinstall mysql-connector-python

重装完成后再次运行脚本验证问题是否解决。

内容的提问来源于stack exchange，提问作者hatahetahmad