为何SQLAlchemy可在Jupyter Notebook导入却无法在虚拟环境中导入？

问题现象 #

• pip list输出确认SQLAlchemy 1.4.45已安装
• 使用Python 3.9.6（darwin系统）解释器时，导入SQLAlchemy或sqlalchemy均触发ModuleNotFoundError
• 已尝试操作：卸载重装SQLAlchemy、停用并重新激活虚拟环境、升级pip

排查与解决步骤 #

1. 验证pip与Python解释器的环境一致性 #

系统中可能存在多版本Python，导致pip安装的包和当前使用的Python不属于同一环境。执行以下命令核对路径：

# 查看pip对应的Python路径
pip --version
# 查看当前Python解释器路径
which python  # macOS/Linux
where python  # Windows

若路径不匹配，需使用对应Python版本的pip重新安装，例如：

python3 -m pip install SQLAlchemy==1.4.45

2. 检查Python的site-packages目录 #

手动确认SQLAlchemy是否真的安装到了当前Python的包目录：

# 在Python解释器中执行
import sys
print(sys.path)

找到输出中的site-packages路径，前往文件系统查看是否存在sqlalchemy（小写）文件夹。若不存在，用对应环境的pip重新安装。

3. 重建虚拟环境 #

若虚拟环境存在异常，尝试删除后重新创建：

# 删除旧虚拟环境（假设环境名为venv）
rm -rf venv
# 创建新环境
python3 -m venv venv
# 激活环境
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # Windows
# 重新安装SQLAlchemy
pip install SQLAlchemy==1.4.45

4. 排查命名冲突 #

确保当前工作目录下没有名为sqlalchemy.py/SQLAlchemy.py的文件，也没有同名文件夹——这些会导致Python优先加载本地文件，而非安装的第三方包。

5. 强制清理缓存并重装 #

若安装缓存损坏，执行强制重装命令：

pip install --force-reinstall --no-cache-dir SQLAlchemy==1.4.45

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