切换为zsh后执行bundle install报错的问题咨询

完全不需要切回bash、重装Ruby/Yarn等整套开发环境，你遇到的bundle install编译报错和shell切换没有本质关联，盲目重装整套环境大概率会遇到一模一样的报错，纯浪费时间。

zsh（哪怕装了oh-my-zsh）和bash的差异只在交互体验层面——比如别名、补全规则、终端配色、命令快捷逻辑。当你在zsh会话里跑bundle、gem install这类开发命令时，加载的Ruby运行时、全局环境变量和bash会话是完全一样的，除非你在.zshrc里硬写了和bash完全不一样的PATH、GEM_HOME路径配置，不然换shell根本不可能直接导致带C扩展的gem编译失败。
你手动安装eventmachine、http_parser反复报错，真正的原因和shell没有关联，基本逃不开这三个：

• 缺系统级编译依赖：这类带C代码的gem，编译前必须先装系统层的编译工具链、对应开发库，很多网上的解决方法只让你手动跑gem安装命令，完全没提前置依赖的事
• gem版本和你新装的Ruby版本不匹配：你是换了SSD全新装的系统，大概率装的是Ruby 3.0以上的版本，而网上旧教程推的老版本eventmachine 1.2.x、http_parser.rb 0.6.x根本不兼容Ruby 3的语法，硬编译肯定报错
• 残留的旧gem目录权限问题：全新系统如果没有清理跨硬盘迁移残留的gem目录权限，可能导致编译时文件写入异常触发报错

1. 先排除shell配置的影响：分别开zsh和bash的终端窗口，执行同一条命令对比输出

   echo $PATH $GEM_HOME $GEM_PATH
   

   如果两边输出完全一致，直接把“zsh配置有问题”这个选项排除，完全不用动shell环境
2. 补全前置的系统依赖：
   • macOS 环境：执行 xcode-select --install 确保完整安装命令行编译工具，不用轻信网上那些“只需要装个gem就行”的简化教程
   • Debian/Ubuntu Linux 环境：执行 sudo apt install build-essential libssl-dev libhttp-parser-dev
3. 别硬装老版本的gem：不要手动强制安装编译报错的旧版本包，直接在项目的Gemfile里把两个依赖升到兼容Ruby 3.x的版本就行：
   • eventmachine 升到1.2.7及以上
   • http_parser.rb 升到0.8.0及以上
     改完重新跑bundle install，基本都能正常完成安装
4. 如果还有权限类的残留报错，跑 gem pristine --all 重置所有已安装gem的编译缓存，再重试安装即可

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