<think>我们参考了多个关于Python导入mysql模块报错的引用资料，总结出以下解决方案： 根据引用[1][2][3]，出现`ModuleNotFoundError: No module named 'mysql'`错误的主要原因是Python环境中没有安装正确的MySQL连接模块。具体解决步骤如下： ### 1. 确认Python版本与MySQL连接模块的兼容性 - Python 2.x 通常使用`MySQLdb`模块 - Python 3.x 推荐使用`mysql-connector-python`或`pymysql`模块 ### 2. 安装正确的MySQL连接模块 根据你的Python版本选择以下命令安装： ```bash # 方案1：安装官方mysql-connector（推荐） pip install mysql-connector-python # 方案2：安装pymysql（纯Python实现） pip install pymysql ``` ### 3. 修改导入方式 根据安装的模块调整导入语句： **使用mysql-connector-python** ```python import mysql.connector # 标准导入方式 conn = mysql.connector.connect( host="localhost", user="yourusername", password="yourpassword", database="yourdatabase" ) ``` **使用pymysql** ```python import pymysql # 注意模块名不同 conn = pymysql.connect( host='localhost', user='yourusername', password='yourpassword', database='yourdatabase' ) ``` ### 4. 验证安装环境 如果安装后仍报错，检查： - 是否在正确的Python环境中安装（特别是使用虚拟环境时） - 通过`pip list`查看已安装包列表 - 尝试重启IDE或命令行终端 ### 5. 虚拟环境注意事项 如果在虚拟环境中工作： ```bash # 激活虚拟环境后再安装 source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows pip install mysql-connector-python ``` ### 示例代码（mysql-connector） ```python import mysql.connector def test_connection(): try: conn = mysql.connector.connect( host="localhost", user="testuser", password="testpass", database="testdb" ) if conn.is_connected(): print("✅ 数据库连接成功") cursor = conn.cursor() cursor.execute("SELECT VERSION()") version = cursor.fetchone()[0] print(f"MySQL服务器版本: {version}") except mysql.connector.Error as err: print(f"❌ 连接错误: {err}") finally: if 'conn' in locals() and conn.is_connected(): conn.close() test_connection() ``` ### 常见错误排查 | 现象 | 解决方案 | |------|----------| | 安装后仍提示找不到模块 | 检查Python环境路径，确保安装位置在sys.path中 | | 权限问题 | 使用`sudo pip install`（Linux/Mac）或以管理员身份运行CMD（Windows） | | 网络超时 | 添加`-i https://pypi.tuna.tsinghua.edu.cn/simple`使用国内镜像源 | > **注意**：在Windows系统上，如果同时安装了多个Python版本（如Anaconda和官方Python），需确认pip是否关联到目标Python环境[^4]。 §§相关问题§§ 1. 如何验证Python中MySQL连接模块是否安装成功？ 2. 使用虚拟环境时安装Python模块有哪些注意事项？ 3. Python连接MySQL数据库有哪些替代方案？ </think> ## Python导入mysql模块出现ModuleNotFoundError的完整解决方案 当遇到`ModuleNotFoundError: No module named 'mysql'`错误时，通常是由于以下原因导致的： ### 🔧 解决方法分步指南 #### 1️⃣ 安装正确的MySQL驱动（核心步骤） 根据你的Python版本选择安装包： ```bash # Python 3.x 用户 pip install mysql-connector-python # 或安装纯Python实现的pymysql（兼容性更好） pip install pymysql # 如果使用Anaconda环境 conda install -c conda-forge mysql-connector-python ``` #### 2️⃣ 验证安装是否成功 在Python交互环境中执行： ```python >>> import mysql.connector >>> print(mysql.connector.__version__) 8.1.0 # 应显示实际版本号 ``` #### 3️⃣ 检查环境路径（当安装后仍报错时） ```python import sys print(sys.path) # 检查模块搜索路径 ``` #### 4️⃣ 解决环境冲突问题 如果使用虚拟环境： ```bash # 确保在虚拟环境中操作 source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows pip install mysql-connector-python ``` ### ⚠️ 不同Python版本的注意事项 | Python版本 | 推荐驱动 | 备选方案 | |------------|------------------|-------------| | 2.x | `MySQL-python` | 升级到Python 3 | | 3.5+ | `mysql-connector-python` | `pymysql` | | 3.8+ | `mysql-connector-python` | `mysqlclient`| ### 💻 连接MySQL的两种代码实现 **使用mysql-connector（官方驱动）:** ```python import mysql.connector config = { 'host': 'localhost', 'user': 'your_username', 'password': 'your_password', 'database': 'your_db' } try: conn = mysql.connector.connect(**config) if conn.is_connected(): print("✅ 成功连接到MySQL数据库") # 执行数据库操作... except mysql.connector.Error as err: print(f"❌ 连接错误: {err}") finally: if conn.is_connected(): conn.close() ``` **使用pymysql（纯Python实现）:** ```python import pymysql connection = pymysql.connect( host='localhost', user='your_username', password='your_password', database='your_db', cursorclass=pymysql.cursors.DictCursor ) try: with connection.cursor() as cursor: cursor.execute("SELECT VERSION()") result = cursor.fetchone() print(f"MySQL版本: {result['VERSION()']}") finally: connection.close() ``` ### 🔍 常见问题排查 1. **多Python环境冲突** ```bash # 明确指定Python版本安装 python3 -m pip install mysql-connector-python ``` 2. **权限问题（Windows）** 以管理员身份运行CMD/PowerShell 3. **代理/防火墙阻挡** 临时关闭防火墙测试安装： ```bash pip --proxy=http://user:pass@proxy:port install mysql-connector-python ``` 4. **缓存问题** 清除pip缓存后重试： ```bash pip cache purge pip install --no-cache-dir mysql-connector-python ``` > **关键提示**：如果使用Anaconda，请确保PATH环境变量正确指向Anaconda的Python路径[^4]，避免与系统Python冲突。