Mac环境下Django安装mysqlclient遇python setup.py egg_info错误求助
解决Mac系统下PyCharm终端安装mysqlclient时
mysql_config: command not found的问题 Hey there! 作为刚上手Django的新手,连续三天卡在这里确实够让人头疼的,我来帮你把这个问题彻底解决掉~
问题根源
mysql_config是MySQL官方提供的配置工具,mysqlclient这个包在安装时需要调用它来获取MySQL的编译和链接参数。Mac系统默认没有预装这个工具,所以才会抛出这个错误,进而导致python setup.py egg_info执行失败。
分步解决方法
我给你列几种最常用的解决方案,按优先级来:
方案1:用Homebrew安装MySQL客户端工具(最推荐)
Homebrew是Mac上最方便的包管理工具,用它装依赖一步到位:
- 打开PyCharm的终端(如果你的终端默认用的是zsh/bash,确保Homebrew已经在环境里)
- 先安装mysql-client:
brew install mysql-client - 安装完成后,需要让系统找到
mysql_config工具,临时生效的话在终端执行:export PATH="/usr/local/opt/mysql-client/bin:$PATH" - 现在再执行安装命令:
pip install mysqlclient - 要是想让这个环境变量永久生效,避免下次打开终端还要重新设置:
- 如果用的是zsh,编辑
~/.zshrc文件,添加上面的export命令 - 如果用的是bash,编辑
~/.bash_profile文件 - 保存后执行
source ~/.zshrc(或对应你的shell配置文件)让修改生效
- 如果用的是zsh,编辑
方案2:如果你已经通过官方DMG包安装了MySQL
如果你之前手动装了MySQL的官方安装包,那mysql_config已经存在,只是系统没找到:
- 它的路径一般是
/usr/local/mysql/bin - 同样先设置环境变量:
export PATH="/usr/local/mysql/bin:$PATH" - 然后执行
pip install mysqlclient即可
方案3:备选方案——使用mysql-connector-python替代
如果上面的方法都遇到问题,可以暂时用Django支持的另一个MySQL驱动:
- 安装命令:
pip install mysql-connector-python - 然后在Django项目的
settings.py里,把数据库引擎修改为:DATABASES = { 'default': { 'ENGINE': 'mysql.connector.django', # 其他配置(NAME、USER、PASSWORD等)保持不变 } }
验证安装成功
安装完成后,回到PyCharm终端执行:
python manage.py migrate
如果没有报错,就说明问题解决啦!
内容的提问来源于stack exchange,提问作者Mervink




