已成功安装psycopg2-binary但导入psycopg2时出现ImportError

问题根源 #

核心原因是pip3安装的包与你执行python命令调用的Python版本不匹配，导致包被安装到了另一个Python环境的site-packages目录中，当前Python进程无法找到。

具体解决步骤 #

• 确认版本对应关系
  分别运行以下命令，检查输出的Python版本是否一致：

  python --version
  pip3 --version
  

  pip3 --version的输出会显示它关联的Python版本（例如：pip 22.0.4 from /usr/local/lib/python3.9/site-packages/pip (python 3.9)），如果和python --version的版本不一致，说明你调用的python是另一个版本（比如Python 2.x）。

• 用匹配的Python版本执行验证命令
  若pip3对应Python3，直接改用python3运行验证脚本：

  python3 -c "import psycopg2; print(psycopg2.__version__)"
  

• 强制用目标Python版本安装包
  若上述方法无效，直接通过Python模块调用pip，确保包安装到当前Python环境：

  python3 -m pip install psycopg2-binary
  

  该命令会调用python3自带的pip工具，彻底避免版本混淆问题。

• 检查虚拟环境状态
  如果你使用了虚拟环境，必须确保：

  • 安装包时处于虚拟环境激活状态
  • 执行验证命令时也在同一个激活的虚拟环境中
    激活命令示例：
  • Linux/macOS：source your_venv/bin/activate
  • Windows：your_venv\Scripts\activate

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