You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac系统下使用Python连接PostgreSQL时遇到导入错误问题

解决psycopg2导入时找不到libpq.5.dylib的问题

这个错误是因为psycopg2依赖PostgreSQL的客户端库libpq,你的系统中缺少该库或者Python无法找到它的路径,以下是几种解决办法:

方法一:安装PostgreSQL客户端库(推荐)

通过Homebrew安装完整的PostgreSQL工具包,它会自动包含libpq:

brew install postgresql

安装完成后,重新运行你的Python脚本即可。

方法二:手动指定libpq路径

如果已经安装了PostgreSQL但系统找不到libpq,可以手动设置环境变量:

  1. 找到libpq的安装路径,Homebrew安装的通常是/usr/local/opt/postgresql/lib
  2. 在终端临时设置环境变量(仅当前会话生效):
export DYLD_LIBRARY_PATH=/usr/local/opt/postgresql/lib:$DYLD_LIBRARY_PATH
  1. 之后再运行你的Python代码。
  2. 若要永久生效,编辑你的shell配置文件(比如~/.zshrc或~/.bash_profile),添加上述export命令,然后执行:
source ~/.zshrc  # 对应zsh
# 或
source ~/.bash_profile  # 对应bash

方法三:安装预编译的psycopg2-binary

这个版本是预编译的二进制包,自带libpq,无需依赖系统库:

  1. 先卸载已安装的psycopg2:
pip uninstall psycopg2
  1. 安装psycopg2-binary:
pip install psycopg2-binary

安装完成后重新运行代码即可。

内容的提问来源于stack exchange,提问作者Abiodun Adeoye

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 16:22:46