mysqlclient安装报错因缺MySQL C头文件和库，Ubuntu/Debian装libmysqlclient-dev，CentOS/RHEL装mysql-devel，macOS用brew install mysql-client并配置PATH，Windows推荐PyMySQL；三者中mysqlclient性能最佳但安装复杂，PyMySQL跨平台易调试，mysql.connector官方但行为不够透明；连接时host=localhost走socket而127.0.0.1走TCP，Docker中应使用服务名；排查连接失败优先检查MySQL进程、命令行直连、用户权限及防火墙。
pip install mysqlclient 总是报错：_mysql.c: No such file or directory
这是 Linux/macOS 上最典型的编译失败，根本原因是缺 MySQL 的 C 头文件和静态库，不是 Python 包本身的问题。
- Ubuntu/Debian：
sudo apt-get install libmysqlclient-dev python3-dev - CentOS/RHEL：
sudo yum install mysql-devel python3-devel（或dnf） - macOS（Homebrew）：
brew install mysql-client，再确保export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"生效 - Windows 用户直接跳过
mysqlclient，改用pymysql（纯 Python 实现，无需编译）
mysql.connector vs PyMySQL vs mysqlclient：选哪个？
三者都支持标准 DB-API，但底层差异直接影响稳定性与性能。
-
mysqlclient是MySQLdb的 Python 3 续命版，C 扩展，速度快、生产环境最稳，但安装门槛高 -
pymysql纯 Python，import pymysql后可直接connect()，调试友好，适合开发/CI/Windows；吞吐量比mysqlclient低 15–30% -
mysql.connector官方驱动，不依赖外部库，但默认不启用 prepared statement，且连接池行为和超时逻辑不如前两者透明 - 如果用 SQLAlchemy，推荐
mysqlclient（URL 写mysql://...）或pymysql（URL 写mysql+pymysql://...）
连接字符串里 host=localhost 和 host=127.0.0.1 居然行为不同？
MySQL 默认把 localhost 当作 Unix socket 连接，而 127.0.0.1 强制走 TCP。这会导致权限、延迟、甚至连接拒绝。
Secure Python Code Sandbox
下载
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
- 检查 MySQL 是否监听 socket：
mysql -u root -e "SHOW VARIABLES LIKE 'socket';" - 如果 Docker 或远程部署，一律用
host='127.0.0.1'，避免 socket 路径不一致 - Docker Compose 场景下，服务名（如
mysql）才是正确 host，不是localhost - 加
port=3306显式声明，防止 MySQL 配置了非标端口却没报错
Connection refused / Can't connect to MySQL server 错误的排查顺序
别急着重装驱动，90% 是环境连通性或权限问题。
立即学习“Python免费学习笔记（深入）”；
- 先确认 MySQL 进程在跑：
systemctl status mysql或ps aux | grep mysqld - 用命令行直连验证：
mysql -h 127.0.0.1 -P 3306 -u your_user -p（注意-P大写） - 检查用户是否允许从当前 host 登录：
SELECT host, user FROM mysql.user;，本地测试建议用'%'或'127.0.0.1'，别只留'localhost' - 防火墙/SELinux 可能拦截：临时关掉
sudo ufw disable或sudo setenforce 0快速验证
charset='utf8mb4' 和 autocommit=True 这两个参数几乎每次都要显式设，否则中文存一半、事务卡住这类问题会反复出现。 
