搭建Django时虚拟环境中无法安装psycopg2的问题求助

错误根源 #

安装psycopg2源码包时，系统找不到pg_config可执行文件——这是因为psycopg2需要PostgreSQL的开发依赖才能完成编译构建。

解决方案 #

方案1：使用预编译二进制包（推荐）

直接安装无需编译的psycopg2-binary包，在虚拟环境中执行：

pip install psycopg2-binary

该包为预编译版本，无需依赖PostgreSQL开发库，可快速解决问题，满足绝大多数Django项目需求。

方案2：安装源码版psycopg2（需编译）

若必须使用源码版，需先安装PostgreSQL开发依赖：

• Ubuntu/Debian：

  sudo apt-get install libpq-dev python3-dev
  

• CentOS/RHEL：

  sudo yum install postgresql-devel python3-devel
  

• Windows：安装PostgreSQL时勾选「Add to PATH」，或手动将PostgreSQL安装目录下的bin文件夹（如C:\Program Files\PostgreSQL\16\bin）添加到系统环境变量PATH中。

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

pip install psycopg2

验证 #

安装完成后，即可正常运行Django的迁移命令：

python manage.py makemigrations

内容的提问来源于stack exchange，提问作者Сергей