Xcode Ruby运行脚本无法找到xcodeproj gem问题求助

我来帮你搞定这个麻烦！你遇到的核心问题是：Xcode默认使用系统自带的Ruby环境，而你通过终端安装的xcodeproj gem存放在用户专属的gem目录里，两者的路径不匹配，所以Xcode里的脚本找不到它。下面是几个简单易操作的解决方案，按步骤来就行：

方案一：让脚本直接指向你的用户gem路径 #

这个方法不用修改系统文件，比较安全：

1. 打开终端，运行命令：

   gem environment
   

   在输出里找到GEM PATHS部分，复制其中的用户路径（看起来像/Users/你的用户名/.gem/ruby/2.3.0）。
2. 打开你Xcode里的Ruby脚本，在最开头添加以下代码（替换成你刚才复制的路径）：

   require 'rubygems'
   # 指定加载用户目录下的gem
   Gem.use_paths(nil, ['/Users/你的用户名/.gem/ruby/2.3.0'])
   require 'xcodeproj'
   

   这样脚本就会优先去你的用户gem目录找xcodeproj了。

方案二：把xcodeproj安装到系统Ruby的目录 #

如果不想改脚本，可以直接把gem装到系统Ruby能识别的路径里，不过需要管理员权限：

• 在终端运行命令：

  sudo gem install xcodeproj -v 1.5.9
  

  输入你的macOS密码后等待安装完成。这样系统Ruby就能找到这个gem，Xcode里的脚本自然也能正常运行。

注意：后续升级macOS可能会重置系统Ruby环境，到时候可能需要重新跑这个命令。

方案三：用Bundler管理依赖（适合长期维护） #

如果你的项目以后会用到更多Ruby gem，用Bundler来统一管理环境会更规范：

1. 先在终端安装Bundler（如果没装过）：

   gem install bundler
   

2. 在你的项目根目录创建一个名为Gemfile的文件，内容如下：

   source 'https://rubygems.org'
   gem 'xcodeproj', '1.5.9'
   

3. 回到终端，在项目根目录运行：

   bundle install
   

   这会生成一个Gemfile.lock文件，锁定依赖版本。
4. 修改Xcode的Run Script配置：把原来的执行命令改成：

   bundle exec ruby 你的脚本文件名.rb
   

   同时修改脚本开头，添加：

   require 'bundler/setup'
   require 'xcodeproj'
   

   这样Xcode会通过Bundler加载正确的gem环境。

为什么会出现这个问题？ #

终端里的Ruby环境和Xcode调用的系统Ruby是两个独立的环境：你直接运行gem install时，gem会被安装到用户目录下（属于个人Ruby环境）；而Xcode默认使用/System/Library/Frameworks/Ruby.framework里的系统Ruby，它的gem搜索路径不包含用户目录，所以就出现了"找不到xcodeproj"的错误。

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