已安装相关库仍报NameError: name 'psycopg2' is not defined问题求助

1. 检查导入语句是否正确 #

• 代码开头必须显式添加import psycopg2语句，仅安装库未添加导入语句会直接触发该报错。
• 如果使用别名导入，比如import psycopg2 as pg，后续所有调用必须使用别名pg，不能再直接写psycopg2调用相关方法。

2. 确认依赖安装环境和运行环境一致 #

• 大概率存在全局环境安装了psycopg2、但代码实际运行在未安装依赖的虚拟环境中的问题，可按以下步骤验证：
  先查看当前代码使用的Python解释器路径：
  which python3 # Linux/macOS环境
  where python # Windows环境
  再用对应路径的解释器执行安装命令，确保依赖安装到对应环境中：
  pip install psycopg2-binary # 优先选择预编译版本，规避编译依赖缺失问题

3. 排查文件命名冲突 #

• 不要将自己编写的代码文件命名为psycopg2.py，否则Python导入时会优先加载你写的同名文件，不会读取真实的第三方psycopg2库，导致无法识别相关属性。

4. 确认IDE解释器配置 #

• 若使用PyCharm、VSCode等IDE运行代码，检查IDE配置的运行解释器是否和你安装psycopg2的解释器为同一个，多数IDE默认会为项目创建独立虚拟环境，和全局环境不互通。

错误截图：

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