Sublime Text 支持 Rails 敏捷开发但需手动配置：①修正 PATH（Mac 改 ~/.zprofile，Windows 设系统级环境变量）；②为 .erb 等文件设置正确语法绑定；③通过 .sublime-project 显式声明索引路径；④避免用 Build System 运行 rails server/console，改用终端或 Terminus 插件。
Sublime Text 能支撑 Rails 敏捷开发，但必须接受它不解析 Ruby、不运行 Bundler、不索引动态方法——所有“快”都建立在你手动拧紧 PATH、索引路径和终端协同的基础上，否则生成器卡住、跳转失效、ERB 不高亮，全是必然结果。
Sublime 启动时找不到 ruby 或 rails？PATH 没被 GUI 进程加载
终端里 ruby -v 正常，但按 Ctrl+B 就报 /bin/sh: ruby: command not found，这是最常见起点错误。GUI 应用（包括双击打开的 Sublime）不读 ~/.zshrc，Mac 用户必须改 ~/.zprofile，加一行：
export PATH="/opt/homebrew/bin:$PATH"
Intel Mac 改成 /usr/local/bin；Windows 用户确认 C:\Ruby32-x64\bin 这类路径进了「系统环境变量」PATH，不是「用户变量」。
验证方式：Sublime 里 Ctrl+` 打开控制台，输入：
import os; print(os.environ.get('PATH'))
输出里没看到 Ruby 路径，就说明没生效。
.erb 文件还是显示 “Plain Text”？语法绑定没设对
Sublime 不会自动把 app/views/layouts/application.html.erb 当作 Rails 模板处理，右下角显示 “Plain Text” 或纯 “HTML” 就是没生效。
临时解决：打开文件 → View → Syntax → Ruby on Rails → HTML (Rails)
永久绑定更关键：
- 右键编辑区底部的语法名（比如 “HTML”）→ Set Syntax as Default for this Extension
- 输入
erb回车确认
如果项目用 .slim 或 .haml，光装 Ruby 插件不够，还得单独装 Slim 或 Haml 插件，且重启 Sublime 才加载。
Ctrl+R 搜不到 helper 或 concern 里的方法？索引路径没显式声明
Ctrl+R 默认只索引当前文件的 def，跨文件的方法（比如 app/helpers/application_helper.rb 或 app/controllers/concerns/authentication.rb）根本不会出现——这不是插件问题，是 Sublime 的设计限制。
必须手动建 .sublime-project 文件，在 folders 里显式列出要索引的路径：
{
"folders": [
{ "path": "." },
{ "path": "app/helpers" },
{ "path": "app/controllers/concerns" },
{ "path": "lib" }
],
"settings": {
"index_files": true,
"index_workers": 4
}
}
改完保存后，等左下角显示 “Indexing… Done”，再搜才有效。否则结果为空是常态，不是你操作错了。
想用插件跑 rails server 或 rails console？别硬塞进 Build System
Build System 是为短命命令设计的（比如 ruby -c），强行塞 rails server 会导致 Sublime 卡死、进程无法终止、端口被占住。
开发阶段最稳做法：
- 终端执行
cd myapp && rails server，Sublime 只管写代码 - 真要嵌入终端：装
Terminus插件，Ctrl+Shift+P→Terminus: Open Default Shell，再输rails server -
Rails Tools的Rails: Run Console默认调rails console，若项目启用了 Spring，大概率卡死；改用终端执行bin/rails c
所有试图让 Sublime “接管服务生命周期”的做法，都会在 Rails 7+ + importmap 场景下率先崩盘——这不是配置不到位，是能力边界所在。
