Mac10.13下Rails5.1.6项目bundle nio4r错误的解决方法

从你提供的错误日志来看，核心问题很明确：你的Mac系统缺少编译Ruby原生扩展所需的C开发工具链。nio4r是依赖原生代码的gem，需要编译器和系统头文件才能完成安装，错误信息里的You have to install development tools first已经直接点明了这点。

下面是一步步的解决步骤：

1. 安装Xcode命令行工具 #

这是Mac上编译原生扩展的基础，打开终端运行：

xcode-select --install

跟着弹出的提示完成安装即可。安装完成后，为了避免后续权限问题，建议再运行以下命令同意Xcode的许可协议：

sudo xcodebuild -license accept

2. 清理残留并重新安装nio4r #

先卸载之前安装失败的nio4r版本：

gem uninstall nio4r

然后尝试直接安装指定版本：

gem install nio4r -v '2.3.1'

如果成功，回到你的项目目录运行bundle install应该就能正常完成依赖安装了。

3. 若仍有问题，检查OpenSSL依赖 #

如果上面的步骤还是失败，可能是OpenSSL库缺失导致的。可以通过Homebrew安装OpenSSL（如果还没装Homebrew，先完成Homebrew的安装）：

brew install openssl

然后指定OpenSSL的路径来安装nio4r：

gem install nio4r -v '2.3.1' -- --with-openssl-dir=$(brew --prefix openssl)

或者直接给Bundler配置这个路径，再执行bundle：

bundle config build.nio4r --with-openssl-dir=$(brew --prefix openssl)
bundle install

你之前参考的Stack Overflow帖子没解决问题，大概率是因为那个帖子针对的是其他场景的nio4r错误，而你的问题根源是最基础的开发工具缺失，这是Ruby原生gem安装失败的常见原因之一。

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