[Python] MySQLdb(即 MySQL-python 包)在 OS X 中安装指南
安装环境:OS X 操作系统,Python 2.7.3。
MySQLdb 其实包含在 MySQL-python 包中,因此无论下载还是在 pip 中 search,都应该是搜寻 MySQL-python。
以下将说明 MySQLdb 两种常见的安装方式,下载安装或者 pip 安装 MySQL-python。
下载MySQLdb
在 SourceForge 可以下载 MySQL-python-1.2.4b4.tar,下载后解压,然后在终端 Terminal 中执行以下命令:
new-host-3:~ iFantastic$ cd /Users/iFantastic/Downloads/MySQL-python-1.2.4b4
new-host-3:MySQL-python-1.2.4b4 iFantastic$ python setup.py install
使用 pip 安装 MySQLdb
在终端中执行:
new-host-3:~ iFantastic$ pip install MySQL-python
无论是在线安装还是下载安装,此时你可能会遇到第一个错误提示:
EnvironmentError: mysql_config not found
建议使用pip安装,因为我从 sourceforge 下载的版本居然不如 pip 中的新。如果想要升级 mysql-python 版本,可以使用以下命令:
$ easy_install MySQL-python --upgrade
[注意]如果你没有按照下文解决安装中的错误提示,那么升级也会因为同样的错误原因而失败。
解决 mysql_config not found 错误
在默认方式安装 Mac 版 MySql 时,会在 /usr/local/mysql/bin 目录下生成 mysql_config 文件。
因此下载安装时的解决办法为:在 MySQL-python 的安装包中找到 site.cfg 文件,打开它,找到以下内容:
# The path to mysql_config. # Only use this if mysql_config is not on your PATH, or you have some weird # setup that requires it. # mysql_config = /usr/local/bin/mysql_config
将最后一句句首井号去掉,并修改为:
mysql_config = /usr/local/mysql/bin/mysql_config
然后执行:
$ python setup.py install
一般说来,此时安装可以完成,但仍有问题,下文会继续阐述。
使用 pip 安装时没有办法修改 site.cfg 文件,因此可以通过修改 OS X 的系统环境变量来解决找不到 mysql_config 的错误。
修改 OS X 环境变量:打开终端,在终端中使用 vim 打开 “~/.bash_profile”,如果没有安装 vim,那就显示隐藏文件用文本编辑器打开,具体操作这里就不复述了。在 .bash_profile 中添加以下内容:
PATH="/usr/local/mysql/bin:${PATH}" export PATH export DYLD_LIBRARY_PATH=/usr/local/mysql/lib/ export VERSIONER_PYTHON_PREFER_64_BIT=no export VERSIONER_PYTHON_PREFER_32_BIT=yes
其中 VERSIONER_PYTHON_PREFER_64_BIT 和 VERSIONER_PYTHON_PREFER_64_BIT 根据自己安装的 MySQL 进行选择。
另外再提供一个 pip 安装时找不到 mysql_config 的解决方法(我没有验证),在终端中输入以下命令:
$ sudo ln -s /usr/local/mysql/bin/* /usr/bin
好了,到这里,MySQL-python 包应该基本顺利安装。
解决 Reason: image not found 错误
安装完 MySQL-python 包后,让我们 import MySQLdb,此时出现一个错误,错误最后一行写着 Reason: image not found。
解决方法是在终端执行:
$ sudo ln -s /usr/local/mysql/lib/libmysqlclient.18.dylib /usr/lib/libmysqlclient.18.dylib
$ sudo ln -s /usr/local/mysql/lib /usr/local/mysql/lib/mysql
之后重启 idle,成功导入 MySQLdb。
PS: 在 Ubuntu 下使用 pip 安装 MySQL-python 同样会出现 mysql_config no found 的错误提示,建议使用 sudo apt-get install python-mysqldb 来进行安装,这样直接可以安装成功。
如果使用 MacPorts 安装 MySQL,MacPorts 安装的源码包都存放在 /opt 目录下,安装完 MySQL 后,使用 port select --list mysql 查看一下当前启用的 MySQL 版本(初次安装完毕后应该是没有启用任何版本的 MySQL),然后使用 port select --set mysql mysql_you_selected 来设置启用的 MySQL 版本,之后再使用 pip 安装则无需担心 mysql-config 的问题。