MacOS下Django已安装mysqlclient仍提示未找到的解决求助

1. 确认mysqlclient在当前虚拟环境中真实生效 #

别跳过这步，再仔细核对一遍：

• 激活虚拟环境后，执行 pip list，查看输出里是否有mysqlclient，确认版本正常显示。
• 执行 which python 和 which pip，检查路径是否指向pyenv虚拟环境目录（比如 ~/.pyenv/versions/你的环境名/bin/python），而非系统全局路径。
• 在Django项目根目录新建测试脚本 test_mysql.py，内容如下：

import MySQLdb
print(MySQLdb.__file__)
print(MySQLdb.version_info)

运行 python test_mysql.py，若能正常输出库路径和版本号，说明库可正常导入；若报错，说明安装过程存在隐性问题，并非环境匹配问题。

2. 检查Django配置文件 #

打开项目的 settings.py，确认DATABASES中的ENGINE配置为 django.db.backends.mysql。如果之前为了兼容pymysql添加过 pymysql.install_as_MySQLdb() 代码，直接删除该行——mysqlclient是原生MySQLdb实现，不需要兼容层。

3. 修正PyCharm的环境配置 #

PyCharm的环境缓存或配置错位可能导致问题：

• 打开 File > Settings > Project: 你的项目名 > Python Interpreter，确认选中的是pyenv创建的目标虚拟环境，且列表中能看到mysqlclient。
• 进入 Run/Debug Configurations，找到runserver的配置项，检查Python interpreter是否选中了正确的虚拟环境，避免使用默认系统解释器。
• 重启PyCharm，清除可能存在的环境缓存。

4. 重新编译mysqlclient（Linux/macOS） #

类Unix系统下，mysqlclient依赖系统级的MySQL开发库，若安装时编译不完整，会出现"假安装"情况：

• 先卸载现有包：pip uninstall mysqlclient -y
• 安装系统依赖：
  • Ubuntu/Debian：sudo apt-get install libmysqlclient-dev
  • macOS（使用brew）：brew install mysql-client，然后执行 export PATH="/usr/local/opt/mysql-client/bin:$PATH"，再重新安装：pip install mysqlclient

5. 匹配Python与mysqlclient版本 #

不同Python版本对mysqlclient有版本要求：比如Python3.11需mysqlclient2.1.0+，Python3.12需2.2.0+。若版本不兼容，即使安装成功也无法正常导入。可指定适配版本安装：pip install mysqlclient==2.2.0（根据你的Python版本选择对应版本）

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