sublime text 需手动配置 path 和插件才能支持 rails 开发：mac 改 ~/.zprofile，windows 加系统 path；推荐 railsgenerator 等插件，禁用 sublimerails 等过时工具；symbol list 需 .sublime-project 显式配置路径并启用索引；勿用 build system 启动 rails server，应使用 terminus 或终端。
Sublime Text 不能自动识别 Rails 项目结构或管理 Gem，它只是个编辑器——你得手动配 PATH、选对插件、用终端补足缺失能力，否则所有“一键生成”“跳转到 model”功能都会失效。
Sublime 启动时找不到 ruby/rails 命令？PATH 没加载
终端里 ruby -v 和 rails -v 都正常，但 Sublime 按 Ctrl+B 就报 /bin/sh: ruby: command not found，说明 GUI 进程没读你的 shell 配置。
- Mac 用户：别往
~/.zshrc里写 PATH，改~/.zprofile（GUI 应用只读这个），加一行export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel），然后完全退出 Sublime 再重开 - Windows 用户：确认
ruby.exe所在目录（如C:\Ruby32-x64\bin）已加入「系统环境变量」PATH，不是「用户变量」 - 验证方式：Sublime 里按
Ctrl+`打开控制台，输入import os; print(os.environ.get('PATH'))，看输出里有没有 Ruby 的 bin 路径
哪些 Rails 插件真能用，哪些该立刻卸载？
社区里大量插件标榜“Rails IDE”，但实际在 Rails 7+ 下基本瘫痪——它们还硬编码 script/generate 或依赖已移除的 sublime-rails 协议。
- 可装且维护尚可：
RailsGenerator（支持bin/rails g controller）、SideBarEnhancements（右键「Open in Terminal」）、ERB Insert Snippets（输入form回车出完整表单） - 慎用或绕开：
Rails Tools的Rails: Run Console默认调rails console，若项目启用了 Spring，大概率卡死；改用终端执行bin/rails c - 必须卸载：
SublimeRails、Ruby Slim（与importmap冲突）、所有带 “auto-index routes.rb” 描述的插件——Sublime 不解析 Ruby 代码，只做字符串匹配
如何让 Ctrl+R（Symbol List）搜到跨文件方法？
Ctrl+R 默认只索引当前文件的 def，Rails 里 helper、concern、engine 里的方法根本不会出现。这不是插件问题，是 Sublime 的设计限制。
- 手动建
.sublime-project文件，在folders里显式列出要索引的路径，例如："path": "app/helpers"、"path": "lib" - 加配置项：
"index_files": true和"index_workers": 4（多核加速），否则大项目索引极慢 - 搜索前务必等左下角显示 “Indexing… Done”，否则结果为空——Sublime 不像 VS Code 那样后台持续索引
- 动态方法（如
belongs_to :user生成的user方法）永远无法被索引，只能靠命名习惯和文档定位
别试图用 Build System 启动 rails server
Tools → Build System → New Build System 写个 "shell_cmd": "rails server" 看似方便，实则危险——Build System 是为短命命令设计的，rails server 是长时进程，会导致：
- Sublime 卡死，无法响应快捷键
- 进程无法终止，端口被占，下次启动失败
- 日志刷屏后无法滚动查看，错误信息被截断
正确做法：用 Terminus 插件开内嵌终端（Ctrl+Shift+T），再执行 bin/rails s；或用 SideBarEnhancements 右键「Open in Terminal」，直接敲命令——编辑器就该专注写代码，运行交给终端。
