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% 是环境连通性或权限问题。

• 先确认 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 这两个参数几乎每次都要显式设，否则中文存一半、事务卡住这类问题会反复出现。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！