MacOS Big Sur下Ruby 2.6.3安装puma 4.3.7编译报错问题

从mkmf.log的报错信息可以明确，错误触发原因是Mac系统的Xcode Command Line Tools（命令行开发工具）未正确安装，或活跃路径配置失效，导致编译puma的原生扩展时无法调用gcc等基础编译工具。

• 第一步：安装Xcode Command Line Tools
  执行命令：

  xcode-select --install
  

  执行后会弹出安装提示窗口，按照指引完成安装即可。如果提示「已安装过该工具」，直接执行下一步。

• 第二步：重置命令行工具的活跃路径
  执行命令修复失效的路径配置：

  sudo xcode-select --switch /Library/Developer/CommandLineTools
  

  输入你的Mac开机密码确认操作即可，输入时密码不会显示，输完直接回车。

• 第三步：验证工具链配置生效
  执行命令验证：

  xcrun --version
  

  能正常输出版本号即说明配置修复完成。

• 第四步：重新安装puma
  执行原安装命令即可：

  gem install puma -v '4.3.7'
  

  如果仍然安装失败，可以指定Homebrew安装的openssl路径进行编译：

  gem install puma -v '4.3.7' -- --with-openssl-dir=$(brew --prefix openssl@1.1)
  

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