Mac OSX下已安装SQLAlchemy却无法导入的问题求助

看起来你遇到了Python解释器与pip安装路径不匹配的典型问题——虽然which -a python只显示了系统默认的/usr/bin/python，但你的pip可能指向了另一个独立的Python 2.7环境（比如通过Homebrew安装的版本），导致安装的包无法被系统Python识别。下面是具体的排查和解决步骤：

1. 确认pip对应的Python版本 #

首先运行这个命令，查看你的pip到底关联的是哪个Python环境：

pip --version

如果输出里的路径是/usr/local/lib/python2.7/site-packages/pip，说明这个pip是给/usr/local/bin/python（第三方安装的Python）用的，而你启动的python是系统默认的/usr/bin/python，这两个是完全独立的环境，所以系统Python找不到你用pip安装的SQLAlchemy。

2. 用对应Python版本的pip重新安装 #

解决这个问题最直接的方法是让pip和你运行的Python保持一致：

• 如果你想在系统默认的Python 2.7中使用SQLAlchemy，运行：

  python -m pip install sqlalchemy
  

  这个命令会强制使用当前python命令对应的pip来安装包，确保包安装到系统Python的site-packages目录。

• 如果你想使用/usr/local下的Python，直接运行这个路径的Python解释器再尝试导入：

  /usr/local/bin/python
  

  然后在解释器里执行import sqlalchemy，应该就能成功了。

3. 检查并添加site-packages路径到Python的sys.path #

如果上面的方法不行，可以手动检查当前Python能识别的路径：
在Python解释器中运行：

import sys
print(sys.path)

看看输出列表里有没有/usr/local/lib/python2.7/site-packages。如果没有，说明这个路径没被当前Python纳入搜索范围，可以临时添加：

sys.path.append('/usr/local/lib/python2.7/site-packages')
import sqlalchemy

如果临时添加有效，想永久解决的话，可以：

• 在用户目录下创建~/.bash_profile（如果没有的话），添加一行：

  export PYTHONPATH="/usr/local/lib/python2.7/site-packages:$PYTHONPATH"
  

  然后运行source ~/.bash_profile生效。
• 或者在系统Python的site-packages目录下创建一个.pth文件，比如sqlalchemy.pth，里面写入/usr/local/lib/python2.7/site-packages。

4. 使用虚拟环境隔离（推荐） #

为了彻底避免这类环境混乱问题，强烈建议使用virtualenv创建独立的Python环境：

# 先安装virtualenv
pip install virtualenv
# 创建一个名为myenv的虚拟环境
virtualenv myenv
# 激活虚拟环境
source myenv/bin/activate
# 在虚拟环境中安装SQLAlchemy
pip install sqlalchemy
# 启动虚拟环境中的Python
python

此时在解释器里执行import sqlalchemy肯定能成功，而且虚拟环境不会影响系统默认的Python环境。

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