RubyMine调试器无法启动，运行时抛出未初始化常量Api错误

核心原因说明 #

你收到的uninitialized constant Api报错和调试工具本身无关，是因为直接运行项目下的〇〇.rb文件时没有提前加载Rails运行环境，导致文件内引用的Api常量无法被识别。同时你本地运行环境和项目定义的版本存在多处不一致，也可能引发额外异常。

修复步骤 #

• 解决常量未初始化问题：
  有两种可选方案，任选其一即可：
  1. 调整RubyMine调试配置：在脚本执行参数中添加-r config/environment，让程序启动前先加载Rails全量环境
  2. 修改待调试脚本：在〇〇.rb文件开头添加require_relative 'config/environment'，路径根据脚本相对于项目根目录的位置调整即可
• 解决版本不匹配问题：
  你的项目Gemfile指定Ruby版本为2.6.5，Docker基础镜像也用的2.6.5，但本地rbenv和RubyMine配置都使用2.7.1版本，版本不一致会导致依赖加载异常，建议统一环境：
  1. 将项目目录下.ruby-version文件内容修改为2.6.5，切换rbenv对应版本
  2. 进入RubyMine的Ruby SDK Gem设置页，切换为rbenv管理的2.6.5版本SDK
  3. 在2.6.5版本下重新安装ruby-debug-ide和debase两个调试依赖
• 若项目本身在Docker容器内运行，建议直接配置RubyMine使用Docker内的Ruby SDK作为调试环境，彻底避免本地和容器环境不一致带来的问题

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