OSX安装pg gem遇Gem::Ext::BuildError：原生扩展构建失败求助

结合你描述的环境差异（Ruby小版本不同、PostgreSQL版本历史差异），以及MacBook Pro用PG9.6能成功安装的情况，我整理了几个针对性的排查和解决步骤：

1. 先确认PostgreSQL服务与配置正常 #

毕竟你之前在MacPro上用PG10.1也遇到过问题，换回9.6.8后先排除数据库本身的问题：

• 检查PostgreSQL是否在运行：执行 brew services list，确认postgresql的状态是started
• 查看本地连接权限配置：打开 /usr/local/var/postgres/pg_hba.conf，找到IPV4本地连接的条目，确保是 host all all 127.0.0.1/32 trust 或者 md5（如果你的Rails数据库配置里指定了密码），避免连接权限导致pg gem安装失败
• 重启PostgreSQL服务：brew services restart postgresql，确保配置生效

2. 处理Ruby版本差异带来的依赖编译问题 #

Ruby 2.4.0和2.4.2虽是小版本升级，但像pg这类带C扩展的gem可能在编译时出现兼容性问题：

• 尝试切换到和MacBook Pro一致的Ruby版本：执行 rbenv install 2.4.0 安装对应版本，再用 rbenv global 2.4.0 切换，重新运行 bundle install 测试
• 如果不想更换Ruby版本，手动指定pg gem的编译参数，确保它能找到Homebrew安装的PG库：

  gem install pg -- --with-pg-config=/usr/local/bin/pg_config
  

  安装完成后再执行 bundle install

3. 清理bundle缓存与旧依赖文件 #

缓存或旧的依赖锁文件可能导致隐藏冲突：

• 强制清空bundle缓存：bundle clean --force
• 删除旧的Gemfile.lock：rm Gemfile.lock，然后重新执行 bundle install 生成新的依赖锁文件
• 查看bundle install的详细错误日志，定位到具体失败的gem，针对性排查该gem在Ruby 2.4.2上的兼容性

4. 检查系统环境变量 #

确保Homebrew的工具优先被调用，避免系统自带工具干扰：

• 执行 echo $PATH，确认 /usr/local/bin 排在路径列表的前面
• 如果没有，临时设置环境变量后再执行bundle：

  export PATH="/usr/local/bin:$PATH"
  bundle install
  

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