Ubuntu 22.04下pip安装mysqlclient失败：无法找到有效pkg-config名称

问题根源 #

你遇到的Can not find valid pkg-config name错误，本质是系统缺少MySQL/MariaDB的开发依赖包。mysqlclient是编译型Python库，需要这些包提供的头文件、链接库等编译资源，而你之前仅安装了pkg-config工具本身，未安装对应的数据库开发组件。

解决步骤 #

1. 安装数据库开发依赖 #

在Ubuntu 22.04系统中，执行以下命令安装所需依赖：

sudo apt-get update
sudo apt-get install libmysqlclient-dev -y

若你使用MariaDB作为数据库，可替换为：

sudo apt-get update
sudo apt-get install libmariadb-dev -y

2. 重新安装mysqlclient #

依赖安装完成后，再次执行安装命令：

pip install mysqlclient

补充提示 #

• 若仍出现normal site-packages is not writeable权限提示，可添加--user参数进行用户级安装：

  pip install mysqlclient --user
  

• 执行依赖安装前务必先更新软件源（sudo apt-get update），避免因源缓存过期导致安装失败。

内容的提问来源于stack exchange，提问作者P.R