Ubuntu 20.04系统Python虚拟环境pip安装psycopg2报错如何解决

报错核心原因 #

安装过程需要从源码编译psycopg2，你的系统缺少Python开发头文件和PostgreSQL编译依赖库，日志中致命错误: Python.h: 没有该文件或目录是明确的报错信号。

解决方案1：使用预编译二进制包（推荐，无需编译） #

直接在激活的虚拟环境中执行以下命令即可，功能和psycopg2完全一致，无需额外安装系统依赖：

pip3 install psycopg2-binary

解决方案2：安装系统依赖后编译安装源码版 #

如果必须使用源码版psycopg2，先执行以下命令安装系统级依赖：

sudo apt update
sudo apt install python3.9-dev libpq-dev gcc

依赖安装完成后，再执行原安装命令：

pip3 install psycopg2

可选操作：升级pip #

日志提示当前虚拟环境pip版本过旧，可执行以下命令升级：

/home/daniel/PycharmProjects/MIA_Practica1/venv/bin/python -m pip install --upgrade pip

内容的提问来源于stack exchange，提问作者Daniel López