<think>我们面对的是用户在使用Python导入mysql模块时出现的ModuleNotFoundError: No module named 'mysql'错误。根据之前的讨论和引用内容，我们可以总结出以下解决方案： 核心问题：缺少MySQL连接驱动模块 解决方案：安装适当的MySQL连接驱动 根据引用[1][2][3]的内容，我们可以知道： - 在Python 3中，传统的MySQLdb模块不再被支持，因此会出现ModuleNotFoundError: No module named 'MySQLdb' - 推荐使用pymysql或mysql-connector-python作为替代 因此，我们的解决方案包括： 1. 安装mysql-connector-python（官方驱动）或pymysql（纯Python实现的替代品） 2. 在代码中正确导入（注意：安装的包名和导入的模块名可能不同） 具体步骤： 步骤1：安装MySQL连接驱动 根据你的需求选择以下两种驱动之一： a) 安装mysql-connector-python（官方）： ```bash pip install mysql-connector-python ``` b) 安装pymysql（纯Python实现，兼容性好）： ```bash pip install pymysql ``` 步骤2：在代码中使用 a) 如果安装的是mysql-connector-python，则导入方式为： ```python import mysql.connector ``` b) 如果安装的是pymysql，则导入方式为： ```python import pymysql ``` 并且，如果你在使用一些需要MySQLdb的框架（如Django或SQLAlchemy），你可能需要添加以下代码来模拟MySQLdb： ```python import pymysql pymysql.install_as_MySQLdb() # 将pymysql伪装成MySQLdb[^3] ``` 步骤3：验证安装是否成功 在命令行中运行Python解释器，尝试导入模块： ```python >>> import mysql.connector # 对于mysql-connector-python >>> import pymysql # 对于pymysql ``` 如果没有报错，则说明安装成功。 步骤4：连接数据库的示例代码 a) 使用mysql-connector-python连接数据库： ```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() ``` b) 使用pymysql连接数据库： ```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() ``` 注意事项： - 如果你在虚拟环境中运行，确保在虚拟环境中安装了驱动。 - 如果你有多个Python版本，确保安装到了正确的Python环境中（比如使用pip3而不是pip）。 如果按照以上步骤操作，应该可以解决ModuleNotFoundError: No module named 'mysql'的问题。 引用说明： [^1] 指出当遇到ModuleNotFoundError: No module named 'pymysql'时，需要安装pymysql模块。 [^2] 提到在Python3中连接MySQL数据库时，如果使用MySQLdb会出现ModuleNotFoundError，解决方案是安装pymysql并修改连接方式。 [^3] 提供了在使用SQLAlchemy时如何用pymysql替代MySQLdb的方法。 因此，我们根据这些引用内容，结合用户的问题，给出了上述解决方案。 如果用户之前尝试安装的是mysql模块（即运行`pip install mysql`），那么请注意，正确的包名不是mysql，而是mysql-connector-python或pymysql。在PyPI上，`mysql`包是一个完全不同的包（通常是一个过时的包），所以不要安装它。 最后，如果问题依然存在，请检查： - 是否在正确的Python环境中执行了安装命令？ - 是否在安装后重新运行了程序？ - 是否在代码中正确导入了模块？ 通过以上步骤，应该能够解决该问题。 </think> 针对Python导入`mysql`模块时出现`ModuleNotFoundError: No module named 'mysql'`错误，以下是完整的解决方案： ### 🔧 核心解决方法 #### 1️⃣ 安装正确的MySQL驱动（关键步骤） ```bash # 官方驱动（推荐） pip install mysql-connector-python # 或纯Python实现的替代方案 pip install pymysql ``` #### 2️⃣ 验证安装结果 ```python # 测试官方驱动 import mysql.connector print(mysql.connector.__version__) # 应显示版本号 # 测试pymysql import pymysql print(pymysql.__version__) ``` ### ⚠️ 不同场景的特殊处理 #### 场景1：使用SQLAlchemy等ORM工具 ```python # 在导入SQLAlchemy前添加 import pymysql pymysql.install_as_MySQLdb() # 伪装成MySQLdb[^3] from sqlalchemy import create_engine engine = create_engine("mysql+pymysql://user:pass@host/db") ``` #### 场景2：Python 2兼容问题（强烈建议升级Python 3） ```python # Python 2.x需安装旧版驱动 pip install MySQL-python # 使用示例 import MySQLdb # 注意模块名不同 db = MySQLdb.connect(host="localhost", user="user", passwd="pass", db="db") ``` #### 场景3：虚拟环境问题 ```bash # 确保激活虚拟环境 venv\Scripts\activate # Windows source venv/bin/activate # Linux/Mac # 在激活的环境安装 pip install mysql-connector-python ``` ### 💻 连接数据库示例代码 #### 使用mysql-connector-python ```python import mysql.connector db = mysql.connector.connect( host="localhost", user="root", password="secret", database="mydb" ) cursor = db.cursor() cursor.execute("SELECT VERSION()") print(f"MySQL版本: {cursor.fetchone()[0]}") ``` #### 使用pymysql ```python import pymysql conn = pymysql.connect( host='127.0.0.1', user='user', password='pass', database='db', charset='utf8mb4' ) with conn.cursor() as cursor: cursor.execute("SHOW TABLES") print(f"数据库表: {cursor.fetchall()}") ``` ### 🔍 深度故障排查 1. **多Python版本冲突** ```bash # 明确指定Python版本安装 python3 -m pip install mysql-connector-python ``` 2. **环境变量问题** 检查PATH是否包含正确Python路径： ```bash echo %PATH% # Windows echo $PATH # Linux/Mac ``` 3. **PyCharm特定设置** - 进入 `File > Settings > Project: [name] > Python Interpreter` - 点击 `+` 搜索安装 `mysql-connector-python` - 确保项目使用的解释器正确 4. **代理问题** ```bash pip install --proxy=http://user:pass@proxy:port mysql-connector-python ``` > **关键提示**：如果使用Anaconda，请运行： > ```bash > conda install -c conda-forge mysql-connector-python > ``` ### 📊 驱动选择参考表 | 使用场景 | 推荐驱动 | 安装命令 | |-----------------------|------------------------|-----------------------------| | 官方兼容性 | mysql-connector-python | `pip install mysql-connector-python` | | Django项目 | mysqlclient | `pip install mysqlclient` | | SQLAlchemy/ORM | pymysql | `pip install pymysql` | | Python 2兼容 | MySQL-python | `pip install MySQL-python` | 通过以上方法，99%的`ModuleNotFoundError`问题都能解决。如仍遇困难，建议检查系统防火墙设置或尝试在Docker纯净环境中测试[^1][^2]。