如何查询Python包的操作系统库依赖？含mysqlclient示例

1. 直接看包的官方安装说明 #

mysqlclient这类原生扩展包，都会在官方文档、PyPI页面或者源码的README里明确列出系统级依赖。比如它常见的系统依赖：

• Debian/Ubuntu 系：libmysqlclient-dev
• RedHat/CentOS 系：mysql-devel
• macOS：一般需要先通过Homebrew安装mysql或mariadb

2. 用pip查看包的元数据（仅作参考） #

pip本身不会直接列出系统依赖，但可以通过以下命令查看包的基本信息，从中找线索：

pip show -f mysqlclient

输出里的Home-page会指向官方文档，Summary或Description部分也可能提到系统依赖的要求。

3. 查看包的源码配置文件 #

原生Python包的系统依赖逻辑通常写在源码的配置文件里：

• 看setup.py或pyproject.toml：mysqlclient的setup.py里会检测系统是否有mysql_config工具，而这个工具就属于系统的mysql开发包
• 看源码根目录的README.md或INSTALL文件：里面会详细写清楚安装前需要准备的系统依赖

4. 借助系统包管理器查询（针对Linux发行版） #

如果你的系统包管理器里有对应版本的python-mysqlclient包，可以直接查它的系统依赖：

• Debian/Ubuntu：

apt depends python3-mysqldb

• RedHat/CentOS：

dnf repoquery --requires python3-mysqlclient

注意：系统包管理器里的包名可能和pip的包名有差异，比如Debian系是python3-mysqldb对应pip的mysqlclient

5. 从安装错误反向推导 #

如果没装系统依赖就用pip装mysqlclient，会抛出编译错误（比如找不到mysql.h头文件），这时就能直接知道需要安装对应的系统开发包。

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