MacOS下安装mysqlclient报错：ld: library not found for -lzlib

问题重现 #

在MacOS系统的Python3.8虚拟环境中，从requirements.txt安装mysqlclient时出现编译错误：

ld: library not found for -lzlib  
clang: error: linker command failed with exit code 1 (use -v to see invocation)  
error: command '/usr/bin/gcc' failed with exit code 1  

已通过Homebrew安装zlib和gcc-13，且在.zshrc中设置了gcc别名，但安装时仍报相同错误。

解决方案 #

1. 明确指定编译环境变量（核心解决方法）

shell别名仅在交互式终端生效，pip编译进程不会读取别名配置，需通过环境变量直接指定编译器和库路径：
激活虚拟环境后执行以下命令：

# 指定zlib的库和头文件路径
export LDFLAGS="-L/usr/local/opt/zlib/lib"
export CPPFLAGS="-I/usr/local/opt/zlib/include"
# 指定使用Homebrew安装的gcc-13作为编译器
export CC=gcc-13
# 执行安装
pip install mysqlclient

也可合并为单条命令一次性执行：

LDFLAGS="-L/usr/local/opt/zlib/lib" CPPFLAGS="-I/usr/local/opt/zlib/include" CC=gcc-13 pip install mysqlclient

2. 补充MySQL依赖（若上述方法仍无效）

mysqlclient编译还依赖MySQL相关库，若未安装可先通过Homebrew安装：

brew install mysql

再指定MySQL的库路径后安装：

LDFLAGS="-L/usr/local/opt/zlib/lib -L/usr/local/opt/mysql/lib" \
CPPFLAGS="-I/usr/local/opt/zlib/include -I/usr/local/opt/mysql/include" \
CC=gcc-13 \
pip install mysqlclient

3. 确保Xcode Command Line Tools完整

若Command Line Tools未安装或损坏，先执行：

xcode-select --install

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