适合Ruby on Rails开发的VSCode常用快捷键配置-VSCode-PHP中文网

ctrl+p不能跳转到rails路由或控制器，需检查.html.erb文件关联为ruby(rails)、安装rails扩展、配置files.associations；f12失效则因solargraph未加载rails上下文，须确保.solargraph.yml含require: ["./config/environment"]且执行bundle exec solargraph bundle。

适合ruby on rails开发的vscode常用快捷键配置

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 问题。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

项目根目录必须存在 .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"]，否则调试器无法注入

Rails 开发中真正卡住人的，往往不是快捷键记不住，而是某个扩展的某一行配置没对上，或者路径字符串里多了一个空格、少了一个点。建议每次改完配置后，用 Cmd+Shift+P → Developer: Toggle Developer Tools 看 Console 有没有 Solargraph 或 Ruby Debug 的报错日志——那才是真实线索。