Ruby-LSP 在 Sublime Text 中无法运行，因其依赖 VS Code 的原生 LSP 实现，而 Sublime 缺乏对 Bundler 环境注入、多根工作区、自动重启等关键能力的支持；第三方 LSP 插件适配不足，导致启动失败、跳转失效或索引不全。
Sublime Text 本身不支持 Ruby-LSP，官方 Ruby-LSP（ruby-lsp）仅提供 VS Code 扩展和 CLI 工具，没有 Sublime Text 的适配层——强行套用会卡死、崩溃或根本无法启动语言服务器。
为什么 Ruby-LSP 在 Sublime Text 里跑不起来
Ruby-LSP 依赖 VS Code 的 Language Server Protocol 实现深度集成：自动启动 ruby-lsp 进程、监听文件变更、注入 Bundler 环境、处理多根工作区、响应 textDocument/definition 等 LSP 请求。Sublime Text 没有原生 LSP 客户端，第三方插件（如 LSP 插件）虽能桥接部分协议，但对 Ruby-LSP 的关键能力支持极弱：
-
LSP插件无法正确传递BUNDLE_PATH和GEM_HOME，导致ruby-lsp启动时找不到项目 gem（尤其用了importmap或zeitwerk的 Rails 7+ 项目） - 跳转到
app/helpers/或lib/下的方法时，返回空结果或超时，因为ruby-lsp默认只索引app/和config/，而 Sublime 的LSP插件不会自动补全"rootPatterns": ["Gemfile", "bin/rails"] - 修改
config/application.rb后，ruby-lsp需要手动重启，但 Sublime 的LSP插件不提供“Restart Server”快捷入口，只能杀进程再重开 Sublime
替代方案：用 Sublime 原生能力补足 LSP 缺失项
放弃 Ruby-LSP 不等于放弃高效开发。Rails 项目结构清晰，靠精准配置 + 少量插件就能达成接近效果：
- 用
RailsGenerator插件替代 LSP 的“生成器”能力：按Cmd+Shift+P→ 输入Rails: Generate，可直接运行bin/rails g controller api/v1/users，无需切终端 - 用
.sublime-project显式声明索引路径，提升跳转准确率：在项目根目录新建该文件，写入：{ "folders": [ { "path": "." }, { "path": "lib" }, { "path": "app/concerns" } ], "settings": { "index_files": true, "index_workers": 4, "index_exclude_patterns": ["node_modules/", "tmp/"] } } - ERB 模板内跳转靠
ERB Insert Snippets+ 手动语法绑定：右键底部Plain Text→Set Syntax as Default for this Extension→ 输入erb；之后输入render回车，自动补全，光标停在引号内，按Cmd+R可搜到对应 partial 文件
构建系统别硬套 ruby-lsp，改用 bundle exec + login shell
想运行 bin/rails routes 或 bundle exec rubocop？别试图把 ruby-lsp 的 CLI 命令塞进 Build System——它不是为长时命令设计的。正确做法是复用你的 shell 环境：
- 新建 Build System（
Tools → Build System → New Build System），内容为：{ "shell_cmd": "zsh -l -c 'cd $folder && bundle exec $1'", "variants": [ { "name": "Routes", "shell_cmd": "zsh -l -c 'cd $folder && bundle exec rails routes'" }, { "name": "RuboCop", "shell_cmd": "zsh -l -c 'cd $folder && bundle exec rubocop $file'" } ] } - 保存为
Rails.sublime-build，之后按Cmd+B弹出菜单选Routes，输出直接显示在 Sublime 底部面板，支持点击行号跳转到对应 route 文件 - Windows 用户请换用
cmd /c并指定完整路径，例如："shell_cmd": "cmd /c cd /d \"$folder\" && bundle exec rails routes"
真正卡住人的从来不是少一个 LSP，而是没搞清 Sublime 的边界：它不管理进程、不解析 Ruby AST、不维护符号表。把 ruby-lsp 当成“必须装”的执念，反而会让 PATH、语法绑定、索引配置这些真正影响效率的事被忽略。
