本文详解 `modulenotfounderror: no module named 'mysqldb'` 的根本原因，重点解决 `pip install mysqlclient` 因缺少系统依赖和 pkg-config 配置而编译失败的问题，并提供跨平台可复用的安装方案。

ModuleNotFoundError: No module named 'MySQLdb' 并非 Python 包未安装的简单提示，而是表明底层 MySQL 客户端驱动（即 mysqlclient）未能成功构建并注册为 MySQLdb 接口。你执行 pip install mysqlclient 时遇到的报错——尤其是 Can not find valid pkg-config name 和 Command 'pkg-config --exists mysqlclient' returned non-zero exit status 1——明确指出：系统缺少 MySQL/MariaDB 开发头文件与动态库，且 pkg-config 无法定位相关配置。mysqlclient 是一个 C 扩展包，需在编译阶段链接 MySQL 客户端库，因此纯 Python 环境无法跳过此步骤。

✅ 正确安装步骤（以 Ubuntu/Debian 为例）

1. 安装系统级依赖（关键前置步骤）：

   sudo apt update
   sudo apt install python3-dev default-libmysqlclient-dev build-essential

   • python3-dev：提供 Python C API 头文件（如 Python.h）；
   • default-libmysqlclient-dev：安装 MySQL 兼容的客户端开发库（含 mysqlclient.pc pkg-config 文件）；
   • build-essential：提供 gcc、make 等编译工具。

2. 验证 pkg-config 是否识别 mysqlclient：

   

   Shadows Python Sensei

   Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

   下载

   pkg-config --exists mysqlclient && echo "OK" || echo "Not found"
   pkg-config --cflags --libs mysqlclient  # 应输出类似 -I/usr/include/mysql -lmysqlclient

   若失败，请确认已安装 libmysqlclient-dev（而非仅 mysql-client）。

3. （可选）手动指定编译参数（当 pkg-config 仍不可用时）：

   export MYSQLCLIENT_CFLAGS="-I/usr/include/mysql"
   export MYSQLCLIENT_LDFLAGS="-L/usr/lib/x86_64-linux-gnu -lmysqlclient"
   pip install mysqlclient

⚠️ 常见误区与注意事项

• ❌ 不要尝试 pip install MySQLdb：该包早已废弃且不兼容 Python 3；
• ❌ 不要仅安装 mysql-server 或 mysql-client：它们不含开发所需的 .h 头文件和 .pc 配置；
• ✅ 推荐使用 mysqlclient（官方维护、Django 默认驱动），它向后兼容 MySQLdb 接口，即 import MySQLdb 在安装 mysqlclient 后可直接工作；
• ? 其他系统适配：
  • CentOS/RHEL/Fedora：sudo yum install python3-devel mysql-devel gcc
  • macOS (Homebrew)：brew install mysql-client && export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"

✅ 验证安装成功

# 在 Python 中测试
import MySQLdb
print(MySQLdb.__version__)  # 应输出类似 '2.2.4'

若仍报错，请检查虚拟环境是否激活、Python 版本是否匹配（mysqlclient>=2.2 支持 Python 3.8+），或运行 pip debug --verbose 确认构建环境完整性。彻底解决此问题的关键在于打通「系统开发库 → pkg-config → Python 编译链」这一闭环。