pip安装psycopg2报错“Error: pg_config executable not found.”

解决pip安装psycopg2时pg_config executable not found.错误
原创 已于 2023-07-06 12:19:48 修改 · 8k 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#python

于 2022-03-22 15:26:26 首次发布
在尝试通过pip安装PostgreSQL数据库适配器psycopg2时，遇到了'Error: pg_config executable not found.'的错误。为了解决这个问题，首先需要安装postgresql，可以使用brew install postgresql命令。如果安装过程中出现'No such file or directory @ rb_sysopen...'错误，请按照相应提示进行处理。完成postgresql的安装后，重新运行pip install psycopg2命令，此时应该能够成功安装psycopg2。

pip安装psycopg2报错“Error: pg_config executable not found.”

1. 现象

在学习部署“学习笔记”项目时，为管理 Heroku 使用的数据库，使用 pip 安装 psycopg2，安装时报错“Error: pg_config executable not found.”：
请添加图片描述

2. 解决方案

安装 postgresql

brew install postgresql

请添加图片描述

3. 验证

再次执行 psycopg2 的 pip 安装命令，成功！

pip install psycopg2

请添加图片描述

最低0.47元/天 解锁文章
Error: pg_config executable not found.
LDC，公众号【轻松学编程】
08-13 6124
pip 安装 psycopg2 安装及错误 现象： Error: pg_config executable not found. Please add the directory containing pg_config to the PATH or specify the full executable path with the option: python setup.py build_ext --pg-config /path/to/pg_config build ... or with th
解决安装psycopg2时pg_config可执行文件未找到的问题
qq_29715355的博客
06-05 1189
在使用Python进行开发时，psycopg2是一个常用的 PostgreSQL 数据库适配器。然而，在使用pip安装psycopg2时，可能会遇到的错误。这通常是因为系统找不到pg_config可执行文件，而pg_config是用于配置和编译与 PostgreSQL 相关的软件所必需的工具。
安装psycopg2出错：Error:pg_config executable not found的解决
热门推荐
muzilanlan的专栏
12-29 4万+
1安装psycopg2PostgreSQL 报错：Error: pg_config executable not found. 执行 python setup.py install running build running build_py running build_ext Error: pg_config executable not found. Please add the directory
pip install psycopg2安装失败经历(MacBook m系列)
2301_76868495的博客
08-07 1321
MacBook m1pro安装使用python相关开发包 psycopg2 和 psycopg2-binary 的方案
如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘psycopg2’ 问题
最新发布
官方推荐：站内优质创作者
09-17 1523
如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘psycopg2’ 问题
Mac 安装psycopg2出错：Error:pg_config executable not found的解决
qq_38122800的博客
01-06 942
然后我又到终端里执行显示以为是安装的psycopg2 版本问题，试了安装15、16都出现以上警告。
安装 psycopg2 的问题:pg_config executable not found
走在搬砖的路上！
10-08 6194
使用 pip install psycopg2，特么报错，Error: pg_config executable not found。 网上搜索下，说需要安装 pg 和 py 的驱动： Debian系: apt-get install libpq-dev python-dev RedHat系： yum install libpqxx-devel python-devel 安装完成，再使用 pip install psycopg2，OK，一切顺利。 有的时候 pip 还经常出现 timeo
python安装psycopg2报错’Error: pg_config executable not found‘
Sajor的博客
07-13 6529
在使用 pip install psycopg2 命令安装时，报了以下错误。’Error: pg_config executable not found‘。看了那么多没营养的中文资源，让我们看看官网是怎么说的吧。
Error: pg_config executable not found
tangsiqi130的博客
07-26 414
pg_config executable not found
windows+miniconda3+vscode连接OpenGauss(import psycopg2报错pg_config executable not found解决方法）
baidu_34681715的博客
11-11 558
之前用的MySQL，python连接它很方便只需要pip install pymysql就可以了。连接OpenGauss(import psycopg2报错解决方法）我的环境windows+miniconda3+vscode。
解决pip install psycopg2出错问题
09-16
主要介绍了解决pip install psycopg2出错问题。具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
pip psycopg2报错 pg_cofig excutable not found
CHENYAoo的博客
06-06 1025
操作系统： centos7.4 原因： 缺少pg组建 `yum install postgresql-devel*` 之后再 pip install psycopg就正常了 看这篇博客得到的办法，感谢。 pip psycopg2报错 pg_cofig excutable not found ...
安装psycopg2时出错:Error: pg_config executable not found.
weixin_30794491的博客
07-01 365
红帽系: 　　安装postgresql-devel Debian系: 　　安装libpq-dev 转载于:https://www.cnblogs.com/ldy-miss/p/11114253.html
pip install psycopg2报错
qq_49491645的博客
02-10 2037
今天玩了一会postgresql，准备用python连接数据库实现查询等操作。安装第三方库的时候突然在liunx环境中pip出现一连串的报错error。这是因为缺少一个依赖包libpq-dev：执行 sudo apt-get install libpq-dev。依赖包安装成功之后再次执行pip install psycopg2即可。
python pip3 安装psycopg2报错
chanelwtt的博客
10-13 2203
安装其它包都可以，只有在安装psycopg2的时候报错，但是pip3 install psycopg2 在其它机器是没有问题的，就说明语句没有错误，报错截图忘记保存了，大概的意思就是不是pip的问题，是包的问题。这台安装不上的机器，已经安装了PG数据库，可能是因为这个对psycopg2的包造成了影响，需要换个包安装：psycopg2-binary，这个包安装上，测试psycopg2也是正常的。
安装并使用 psycopg2 报错 pg_config executable not found 或 import psycopg2 报错
weixin_46311222的博客
06-05 1259
psycopg2-binary 是 PostgreSQL 的 Python 驱动库，安装时需要依赖 PostgreSQL 提供的开发工具 pg_config。- 即使系统已安装 PostgreSQL，虚拟环境中 pg_config 不在 PATH，也会导致安装失败或运行时报错。| 中国科技大学 | https://pypi.mirrors.ustc.edu.cn/simple |- pg_config 缺失是安装失败的核心问题，建议通过 Homebrew 安装 PostgreSQL 解决。
Error: pg_config executable not found. pg_config is required to build psycopg2 from source. Please add the directory containing pg_config to the $PATH or specify the full executable path with the option: python setup.py build_ext --pg-config /path/to/pg_config build ... or with the pg_config option in 'setup.cfg'. If you prefer to avoid building psycopg2 from source, please install the PyPI 'psycopg2-binary' package instead. For further information please check the 'doc/src/install.rst' file (also at <https://www.psycopg.org/docs/install.html>). ---------------------------------------- ERROR: Command errored out with exit status 1: python setup.py egg_info Check the logs for full command output.
08-15
<think>根据用户的问题和提供的引用内容，用户遇到了安装psycopg2时出现的"pg_config executable not found"错误。pg_config是PostgreSQL的一个工具，用于获取已安装PostgreSQL的信息，psycopg2在编译安装时需要这个工具。 解决方案： 1. **确保PostgreSQL已安装**：因为pg_config是PostgreSQL的一部分，所以首先需要确认系统上已经安装了PostgreSQL。如果没有安装，需要先安装PostgreSQL。 2. **将pg_config所在目录加入PATH**： 在Linux/macOS上，可以通过以下命令临时添加（假设PostgreSQL安装在默认位置）： ```bash export PATH=$PATH:/usr/local/pgsql/bin ``` 或者永久添加，将上述命令添加到`~/.bashrc`或`~/.zshrc`中。 3. **在安装时指定pg_config路径**： 如果知道pg_config的具体路径，可以在安装psycopg2时指定： ```bash pip install psycopg2 --global-option=build_ext --global-option="-I/usr/local/pgsql/include" --global-option="-L/usr/local/pgsql/lib" ``` 或者使用setup.cfg文件配置，但通常使用命令行参数更方便。 4. **使用psycopg2-binary（推荐）**： 对于开发环境，可以使用预编译的二进制包psycopg2-binary，它不需要编译，因此也就无需pg_config： ```bash pip install psycopg2-binary ``` 注意：官方文档建议在生产环境中使用psycopg2（需要编译），但开发环境可以用binary版。 5. **安装PostgreSQL开发包（Linux）**： 在基于Debian的系统（如Ubuntu）上，可以安装libpq-dev包，它提供了pg_config： ```bash sudo apt-get install libpq-dev ``` 在基于RPM的系统（如CentOS）上，安装postgresql-devel： ```bash sudo yum install postgresql-devel ``` 6. **macOS特定解决方案**： 在macOS上，如果使用Homebrew安装了PostgreSQL，那么pg_config应该已经在PATH中。如果没有，可以尝试重新链接： ```bash brew install postgresql brew link postgresql --force ``` 或者，如果已经安装，可以尝试： ```bash brew reinstall postgresql ``` 然后安装psycopg2-binary（因为macOS的Python环境可能缺少dev支持）： ```bash pip install psycopg2-binary ``` 7. **Windows系统**： 在Windows上，通常安装完整的PostgreSQL安装包（如EnterpriseDB提供的安装包）会包含pg_config，并会自动添加到PATH。如果没有，可以手动将PostgreSQL的bin目录（如`C:\Program Files\PostgreSQL\14\bin`）添加到系统环境变量PATH中。 8. **验证pg_config是否可用**： 安装完成后，在终端运行： ```bash pg_config --version ``` 如果能够输出PostgreSQL的版本信息，则说明pg_config已经可用。 9. **重新安装psycopg2**： 在确保pg_config可用后，重新安装psycopg2： ```bash pip uninstall psycopg2 pip install psycopg2 ``` 注意：根据引用[2]，在macOS上，推荐使用psycopg2-binary，因为mac的Python通常没有安装python-dev，而psycopg2-binary是预编译的二进制包，避免了编译依赖。 总结步骤： - 安装PostgreSQL（如果未安装）或安装对应的开发包（如libpq-dev） - 确保pg_config在PATH中 - 如果不想处理依赖，使用psycopg2-binary（开发环境推荐） - 重新安装psycopg2 最后，根据用户的问题，生成相关问题。</think>### 解决 "pg_config executable not found" 错误的完整指南 当安装 `psycopg2` 时出现 `pg_config executable not found` 错误，表明系统缺少 PostgreSQL 的开发依赖。以下是针对不同操作系统的解决方案： #### 1. **Linux 解决方案（Ubuntu/Debian）** ```bash # 安装 PostgreSQL 开发包 sudo apt-get update sudo apt-get install libpq-dev python3-dev # 验证 pg_config which pg_config # 应输出路径如 /usr/bin/pg_config # 重新安装 psycopg2 pip install psycopg2 ``` #### 2. **macOS 解决方案** ```bash # 通过 Homebrew 安装 PostgreSQL brew install postgresql # 将 pg_config 添加到 PATH（临时） export PATH="/usr/local/opt/postgresql/bin:$PATH" # 永久添加路径（推荐） echo 'export PATH="/usr/local/opt/postgresql/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # 使用二进制版本避免编译问题 [^2] pip install psycopg2-binary ``` #### 3. **Windows 解决方案** 1. 下载 PostgreSQL 安装包：https://www.postgresql.org/download/ 2. 安装时勾选 **Command Line Tools** 3. 将 PostgreSQL 的 bin 目录添加到系统 PATH： - 默认路径：`C:\Program Files\PostgreSQL\15\bin` 4. 在命令提示符验证： ```cmd pg_config --version ``` 5. 安装预编译包： ```cmd pip install psycopg2-binary ``` #### 4. **手动指定 pg_config 路径** 如果知道 `pg_config` 位置但不在 PATH 中： ```bash pip install psycopg2 --global-option=build_ext \ --global-option="-I/usr/local/opt/postgresql/include" \ --global-option="-L/usr/local/opt/postgresql/lib" ``` #### 5. **验证安装** ```python import psycopg2 try: conn = psycopg2.connect("dbname=test user=postgres") print("连接成功!") except Exception as e: print("错误:", e) ``` #### 各操作系统依赖包总结 | 系统 | 所需依赖包 | 验证命令 | |---------|-----------------------------|-------------------| | Ubuntu | `libpq-dev python3-dev` | `dpkg -l libpq-dev` | | CentOS | `postgresql-devel python3-devel` | `rpm -q postgresql-devel` | | macOS | `postgresql` (via Homebrew) | `brew list postgresql` | | Windows | PostgreSQL 安装包 (含CLI工具) | `pg_config --version` | > **关键提示**：开发环境强烈推荐使用 `psycopg2-binary` 可避免 90% 的编译问题[^2]。生产环境建议使用完整编译的 `psycopg2` 并确保 `pg_config` 在 PATH 中。
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值