Windows10安装psycopg2提示pg_config executable not found怎么解决

你遇到的英文报错翻译成中文如下：

错误：未找到 pg_config 可执行文件。

从源码编译 psycopg2 必须要有 pg_config。请将包含 pg_config 的目录添加到 $PATH 环境变量中，或者通过以下选项指定 pg_config 的完整可执行路径：

    python setup.py build_ext --pg-config /path/to/pg_config build ...

也可以在 setup.cfg 中配置 pg_config 选项。

如果你不想从源码编译 psycopg2，请安装 PyPI 上的 'psycopg2-binary' 包。

更多信息请查看 doc/src/install.rst 文件。

首先明确：Windows 系统不存在独立的 libpq-dev 软件包，该包是 Debian、Ubuntu 等 Linux 发行版专属的 PostgreSQL 开发依赖包，你遇到的报错无需安装这个包，按以下方案解决即可。

方案1：优先选择（无需编译，快速解决） #

直接安装预编译好的 psycopg2 二进制版本，跳过源码编译环节，也就不需要读取 pg_config 配置：

pip install psycopg2-binary

该包功能和原生 psycopg2 完全一致，绝大多数开发场景都可直接使用。

方案2：必须安装原生 psycopg2 时的解决方法 #

你本地已经安装了 PostgreSQL，pg_config 执行文件已经存在于 PostgreSQL 的安装目录中，只需要让安装程序找到它即可：

1. 先找到 pg_config.exe 的实际路径，默认安装路径为 C:\Program Files\PostgreSQL\<你的PG版本号>\bin，比如安装的是PG15版本，对应路径就是 C:\Program Files\PostgreSQL\15\bin
2. 两种配置方式二选一即可：
   • 把上述bin目录添加到系统环境变量PATH中，添加完成后重启终端，重新执行pip install psycopg2即可
   • 安装时直接指定pg_config路径，示例命令如下（注意替换为你自己的实际路径）：

   pip install psycopg2 --global-option=build_ext --global-option="--pg-config=C:\Program Files\PostgreSQL\15\bin\pg_config.exe"
   

注意：如果路径包含空格，必须用引号把路径完整包裹，避免命令识别错误。

内容的提问来源于stack exchange，提问作者Binay Agarwal