Mac Monterrey安装psycopg2后仍出现ModuleNotFoundError的解决方法

• 确认Python解释器与pip的对应关系
  运行以下命令检查当前python3和pip3是否指向同一个Python版本：

  # 查看python3的路径
  which python3
  # 查看pip3的路径
  which pip3
  # 更准确的方式：查看python3对应的pip版本信息
  python3 -m pip --version
  

  如果输出显示两者对应不同的Python环境（比如python3是系统自带的/usr/bin/python3，而pip3是brew安装的/usr/local/bin/pip3），就会出现包安装路径不匹配的问题。

• 使用python3 -m pip重新安装psycopg2
  直接通过当前python3解释器调用pip安装，确保包被安装到该解释器的site-packages目录：

  python3 -m pip install psycopg2
  

• 检查脚本的shebang行
  查看脚本开头的shebang声明，如果是#!/usr/bin/env python，在Monterrey系统中这可能指向Python 2.x，改为#!/usr/bin/env python3，确保脚本使用正确的解释器：

  #!/usr/bin/env python3
  import psycopg2
  # 其他脚本内容
  

• 虚拟环境适配（若使用虚拟环境）
  如果脚本是在虚拟环境中运行，全局安装的psycopg2不会被虚拟环境识别，需先激活虚拟环境再安装：

  # 激活虚拟环境（替换为你的虚拟环境路径）
  source venv/bin/activate
  # 在虚拟环境内安装psycopg2
  pip install psycopg2
  

• 手动添加site-packages路径到Python搜索路径
  运行以下命令查看当前python3的搜索路径：

  python3 -c "import sys; print(sys.path)"
  

  如果输出中没有/usr/local/lib/python3.9/site-packages，可以在脚本开头手动添加该路径：

  import sys
  sys.path.append('/usr/local/lib/python3.9/site-packages')
  import psycopg2
  

  或者临时设置环境变量后运行脚本：

  export PYTHONPATH=/usr/local/lib/python3.9/site-packages:$PYTHONPATH
  python3 my_script.py
  

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