MacOS下pkg-config检测mysqlclient返回1，但pip显示已安装

问题本质 #

你遇到的情况是：pip安装的mysqlclient是Python绑定包，但pkg-config --exists mysqlclient检测的是系统层面的MySQL C开发库的配置文件，两者不是一回事。哪怕Python包已经装好，只要pkg-config找不到MySQL开发库的.pc配置文件，就会返回非0状态码。

具体解决步骤 #

1. 确认pkg-config的搜索路径问题
   执行以下命令，检查是否能找到mysqlclient的配置：

   pkg-config --list-all | grep mysql
   

   如果没有输出，说明.pc文件不在pkg-config的默认搜索路径里。

2. 添加MySQL的pkg-config路径到环境变量

   • 若用MacOS官方DMG安装的MySQL，默认安装路径为/usr/local/mysql，.pc文件位于/usr/local/mysql/lib/pkgconfig/。执行以下命令临时生效：

     export PKG_CONFIG_PATH="/usr/local/mysql/lib/pkgconfig:$PKG_CONFIG_PATH"
     

     如需永久生效，将这行代码添加到~/.zshrc（使用zsh时）或~/.bash_profile（使用bash时），保存后重启终端或执行source ~/.zshrc（对应你的配置文件）。

   • 若用Homebrew安装的MySQL，.pc文件路径一般为/usr/local/opt/mysql/lib/pkgconfig/，执行：

     export PKG_CONFIG_PATH="/usr/local/opt/mysql/lib/pkgconfig:$PKG_CONFIG_PATH"
     

3. 补装MySQL开发库（如果缺失）
   若上述路径中找不到.pc文件，说明可能未安装MySQL开发头文件和库：

   • 官方DMG重装时，选择「Customize」选项，确保勾选「MySQL Development Headers and Libraries」。
   • Homebrew环境下直接安装：

     brew install mysql-client
     

为什么pip装了mysqlclient还会报错？ #

pip安装的mysqlclient是Python绑定库，它在安装时依赖系统的MySQL开发库，但安装完成后不会自动配置pkg-config的搜索路径，因此脚本用pkg-config检测时，仍找不到系统级的MySQL开发库配置，导致返回码1。

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