启动Rails开发服务器报找不到ruby-debug-ide gem错误解决方法

你看到的是Ruby包管理器RubyGems抛出的依赖查找异常：

/Library/Ruby/Site/2.6.0/rubygems.rb:265:in `find_spec_for_exe': can't find gem ruby-debug-ide (>= 0.a) with executable rdebug-ide (Gem::GemNotFoundException)
from /Library/Ruby/Site/2.6.0/rubygems.rb:284:in `activate_bin_path'
from /usr/local/bin/rdebug-ide:23:in `<main>'

这个报错的本质是系统在全局Ruby安装路径下找不到ruby-debug-ide这个调试用gem包的可执行文件rdebug-ide，几乎都是VS Code的Ruby调试插件自动触发调试启动逻辑时，没有走项目的bundle依赖环境，直接去全局路径找包导致的，和Rails项目本身的业务代码无关。

• 先验证项目基础依赖是否完整：进入项目根目录，在终端执行bundle install，等待所有Gemfile中声明的依赖安装完成后，执行bundle exec rails s，如果服务能正常启动，说明项目本身环境没有问题，只是调试配置的路径匹配错误。
• 如果不需要用VS Code的断点调试功能，直接忽略这个报错即可，平时启动服务、执行Rails相关命令时都带上bundle exec前缀，强制命令在当前项目的依赖环境中运行，就不会触发全局找调试包的逻辑。
• 如果需要使用VS Code的调试功能，先在项目根目录执行bundle add ruby-debug-ide --group development,test把调试依赖加到项目的开发测试组依赖中，再执行bundle install完成安装。之后打开VS Code的Ruby调试配置文件，在配置项中添加"useBundler": true，让调试插件自动通过bundle环境加载gem，不会再去全局路径查找包。
• 如果执行完上述操作还是报错，检查本地是否安装了多个Ruby版本，确认VS Code终端里执行ruby -v输出的版本号，和项目要求的Ruby版本、bundle安装依赖使用的Ruby版本完全一致，版本不一致也会导致gem路径查找失败。

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