使用asdf管理环境安装psycopg2报错：No version is set for command pg_config

核心原因 #

pip执行python setup.py egg_info时，子进程没有继承当前shell的PATH环境，导致asdf的shim无法正确定位pg_config对应的版本——即便当前shell里pg_config路径显示正常也没用。

可行解决方案 #

1. 直接指定pg_config路径给pip #

绕开PATH的问题，强制把pg_config的绝对路径传给pip：

PG_CONFIG=$(which pg_config) pip install psycopg2

也可以手动写死asdf shim的路径（通常是~/.asdf/shims/pg_config）：

PG_CONFIG=~/.asdf/shims/pg_config pip install psycopg2

2. 让子进程也加载asdf配置 #

检查你的shell配置文件（bash用~/.bashrc，zsh用~/.zshrc），确保asdf的初始化代码在非交互式shell里也能生效：

• 如果之前把asdf初始化放在.bash_profile，移到.bashrc里
• 或者直接在.bashrc添加以下代码：

. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash

这样setup.py调用的子进程会自动加载asdf的shim路径。

3. 确认项目目录的asdf局部配置 #

• 检查项目目录（或父目录）的.tool-versions文件，确保里面有postgres 11.8
• 进入项目目录执行asdf local postgres 11.8，强制设置局部版本
• 执行asdf current postgres确认当前目录使用的是11.8版本，避免父目录配置覆盖

4. 临时用预编译包应急 #

如果以上方法都没效果，可以先装预编译的二进制包跳过编译：

pip install psycopg2-binary

注意：生产环境优先用源码编译的psycopg2，二进制包可能存在兼容性隐患。

内容的提问来源于stack exchange，提问作者Jon McClung