Ubuntu 20虚拟环境中Django安装mysqlclient报错求助

这个报错的核心原因是系统缺少MySQL/MariaDB的开发依赖包，导致mysqlclient无法通过pkg-config找到编译所需的库文件。按照以下步骤解决：

步骤1：安装系统级依赖包 #

退出虚拟环境，在系统终端执行以下命令安装编译依赖：

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

• python3-dev：提供Python扩展开发所需的头文件
• default-libmysqlclient-dev：MySQL客户端的开发库，包含编译mysqlclient需要的头文件和库
• build-essential：提供gcc等编译工具链

步骤2：重新安装mysqlclient #

激活你的Django虚拟环境，再次执行安装命令：

pip install mysqlclient

备选方案：手动指定环境变量（若步骤1无效） #

如果安装依赖后仍报错，可通过mysql_config命令手动获取并设置环境变量：

# 获取并设置编译参数
export MYSQLCLIENT_CFLAGS=$(mysql_config --cflags)
export MYSQLCLIENT_LDFLAGS=$(mysql_config --libs)

# 再次安装mysqlclient
pip install mysqlclient

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