Python导入mysql.connector遇ModuleNotFoundError问题求助

可行排查与修复步骤 #

• 验证Python解释器与pip的匹配性
  系统中多Python版本共存时，pip安装的包可能不在当前脚本使用的环境里。执行以下操作确认：

  • 在脚本开头添加代码并运行，查看当前Python路径：import sys; print(sys.executable)
  • 执行pip --version，对比输出中的Python版本和路径是否与上述结果一致。若不一致，改用对应版本的pip安装，比如python3.11 -m pip install mysql-connector-python，确保包安装到当前使用的Python环境。

• 检查导入语句正确性
  确认脚本中导入语句为import mysql.connector，避免import mysql-connector-python这类错误写法。

• 确认模块是否真的安装成功
  执行python -c "import site; print(site.getsitepackages())"获取当前Python环境的site-packages路径，进入该目录查看是否存在mysql文件夹及其中的connector子模块。若不存在，执行强制重装命令：

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

• 重新确认虚拟环境激活状态
  终端窗口切换可能导致虚拟环境失效，重新执行激活命令（Windows：venv\Scripts\activate；Linux/macOS：source venv/bin/activate），再运行脚本测试。

• 临时添加路径排查环境问题
  若上述步骤无效，可在脚本中手动添加site-packages路径到sys.path，验证是否为路径配置问题：

  import sys
  sys.path.append("/你的site-packages绝对路径")
  import mysql.connector
  

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