Mac系统下已安装psycopg2但Python导入报Pylance缺失模块错误如何解决

这个Import "psycopg2" could not be resolved from source Pylance(reportMissingModuleSource)报错本质是编辑器的Pylance组件未识别到你安装了psycopg2的Python环境，和你终端安装包用的pip对应的Python环境不一致，少数情况是Mac Big Sur系统下psycopg2的安装兼容问题，可按以下步骤排查解决：

步骤1：核对Python解释器路径 #

Mac系统默认自带Python2.7，很多用户会额外安装Python3，常出现终端pip对应的环境和编辑器用的环境不一致的情况：

• 先在终端执行pip3 --version，输出内容里会显示当前pip对应的Python安装路径
• 打开VS Code，按Cmd + Shift + P调出命令面板，输入Python: Select Interpreter，选择和终端输出路径完全一致的Python解释器即可

步骤2：排查虚拟环境适配问题 #

如果你使用了venv、conda等虚拟环境管理工具，需确认包安装到了当前激活的虚拟环境中：

• 激活你当前项目使用的虚拟环境：
  • venv环境执行：source 你的虚拟环境目录/bin/activate
  • conda环境执行：conda activate 你的环境名称
• 激活后重新安装psycopg2-binary，避免源码编译兼容问题：

  pip uninstall -y psycopg2 psycopg2-binary
  pip install psycopg2-binary==2.8.6
  

步骤3：清理Pylance缓存 #

如果确认解释器和包安装都没问题，就是Pylance缓存未更新导致的报错：

• 按Cmd + Shift + P调出命令面板，输入Developer: Reload Window，重载编辑器窗口后Pylance会重新扫描已安装的依赖包，报错就会消失。

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