Ctrl+P不能跳转到Rails路由或控制器，需检查.html.erb文件关联为Ruby(Rails)、安装Rails扩展、配置files.associations；F12失效则因Solargraph未加载Rails上下文，须确保.solargraph.yml含require: ["./config/environment"]且执行bundle exec solargraph bundle。
Ctrl+P 不能跳转到 Rails 路由或控制器？检查文件关联和扩展激活状态
VSCode 默认把 .html.erb 当作 HTML 处理，导致 Ctrl+P（Go to File）搜不到 users_controller.rb 或 routes.rb，甚至搜到也打不开正确语言模式。这不是快捷键失效，而是语言服务没接管。
- 手动确认当前 ERB 文件右下角显示的是
Ruby (Rails)，不是HTML；如果不是，点击它 → 选择Configure File Association for '.html.erb'...→ 设为Ruby (Rails) - 确保已安装
Rails扩展（by bung87 或 Hooch），它提供config/routes.rb解析能力；仅靠Ruby和Solargraph不够 -
Ctrl+P输入routes后，若出现config/routes.rb但点不进去，说明files.associations没生效，需在设置中加："files.associations": {"*.html.erb": "ruby"}（注意不是erb）
F12 跳转定义失败？Solargraph 没加载 Rails 上下文
按 F12 点 belongs_to :author 却提示 “No definition found”，大概率是 Solargraph 没读取 Rails 的自动加载路径，不是 Ruby 版本或 gem 问题。
- 项目根目录必须存在
.solargraph.yml，且至少含require: ["./config/environment"]—— 这行让 Solargraph 加载 Rails 初始化环境，否则无法识别ActiveRecord::Base子类方法 - 运行
bundle exec solargraph bundle（不是solargraph bundle），否则它不会扫描Gemfile中的 Rails 相关 gem - VSCode 设置里确认
solargraph.autoStart为true，且重启过编辑器；临时禁用其他 Ruby 相关扩展（如 Ruby Symbols）可排除冲突
Cmd+Shift+O（Mac）或 Ctrl+Shift+O（Win/Linux）切换 spec 与实现文件无效？Rails Go To Spec 配置未触发
Rails Go To Spec 扩展依赖文件命名约定和路径结构，不是装了就能用。常见现象是快捷键响应但无反应，或跳到错误文件。
- 确保 controller 文件名是
users_controller.rb，对应 spec 是spec/controllers/users_controller_spec.rb；如果 spec 在spec/requests/下，它默认不识别 - 扩展设置中检查
railsGoToSpec.specRoot是否指向spec，且railsGoToSpec.controllerDir是app/controllers - 快捷键冲突：某些键盘布局下
Cmd+Shift+O被系统占用，可改用命令面板输入Rails: Go To Spec测试是否扩展本身工作正常
调试时断点不命中？launch.json 缺少 pathToRDebugIDE 或开发环境配置错
按下 F5 启动调试，代码执行完全忽略断点，控制台也不报错——这通常不是插件没装，而是 Ruby Debug 找不到调试器入口。
-
launch.json中必须显式指定"pathToRDebugIDE"，值为gem which ruby-debug-ide输出路径（例如/Users/you/.rbenv/versions/3.1.4/lib/ruby/gems/3.1.0/gems/ruby-debug-ide-2.9.0/bin/rdebug-ide） -
config/environments/development.rb中需有config.cache_classes = false，否则修改代码后断点位置会偏移 - 不要用
bin/rails server启动调试，launch.json的program字段应设为"${workspaceFolder}/bin/rails"，args设为["server", "-p", "3000"]，否则调试器无法注入
Cmd+Shift+P → Developer: Toggle Developer Tools 看 Console 有没有 Solargraph 或 Ruby Debug 的报错日志——那才是真实线索。 
