sublime text 找不到 ruby/rails 命令是因为 gui 启动不加载 shell 配置（如 ~/.zshrc），需 mac 改 ~/.zprofile、windows 加系统 path，并用 import os; print(os.environ.get('path')) 验证。
Sublime Text 里跑不了 rails server 或 ruby -c，不是 Ruby 没装，是它根本没看到你的 Ruby 环境——PATH、语法、终端三件事没拧紧，所有功能都会卡在第一步。
Sublime 启动后 ruby 命令找不到？先看它实际加载的 PATH
终端里 ruby -v 正常，但 Sublime 按 Ctrl+B 就报 /bin/sh: ruby: command not found，说明 GUI 进程压根没读你的 shell 配置。这不是插件问题，是启动机制决定的。
- Mac 用户：别改
~/.zshrc，改~/.zprofile，加一行export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel），改完必须完全退出 Sublime 再重开 - Windows 用户：把
ruby.exe所在目录（如C:Ruby32-x64in）加入「系统环境变量」PATH，不是「用户变量」 - 验证方式：按
Ctrl+`打开 Sublime 控制台，输入import os; print(os.environ.get('PATH'))，输出里必须出现 Ruby 的 bin 路径
如何让 Ctrl+B 正确运行 .rb 文件？Build System 必须带登录态 shell 或绝对路径
裸写 "cmd": ["ruby", "$file"] 在 GUI 下大概率失败；关键是要让 shell 初始化逻辑生效，否则 rbenv 或 rvm 管理的 Ruby 版本根本不会被识别。
- macOS/Linux（用 zsh）：
"shell_cmd": "zsh -l -c "ruby '$file'""——-l表示登录态，会加载~/.zshrc，从而识别rbenv的 shims - Windows：
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 反斜杠必须双写，路径不能含空格，否则静默失败 - 必须配
file_regex，否则错误行点不动："file_regex": "^([^:]*):([0-9]+):?([0-9]*)"匹配标准 Ruby 报错格式（如test.rb:5:in `foo': ...）
.erb 文件还是 Plain Text？语法绑定必须手动做，没有自动识别
Sublime 不会根据文件内容或项目结构推断模板类型，app/views/layouts/application.html.erb 默认就是纯文本，右下角显示 “Plain Text” 就是没生效。
- 临时解决：打开文件 →
View → Syntax → Ruby on Rails → HTML (Rails) - 永久绑定：切换后，点击右下角语法名 →
Set Syntax as Default for this Extension，输入erb确认 - 如果用了
.slim或.haml，光装 Ruby 插件不够，得单独装Slim或Haml插件，且重启 Sublime 才加载
为什么 F12 跳转不到 helper 或 concern 里的方法？这不是插件没装全，是 Sublime 的索引机制限制
Sublime 没有 RubyMine 那种语义级符号索引能力，默认 Ctrl+R 只搜当前文件的 def，跨文件、跨目录的方法天然不在索引范围内。
- 必须建
.sublime-project文件，在folders里显式列出要索引的路径，例如："path": "app/helpers"、"path": "lib" - 加配置项：
"index_files": true和"index_workers": 4（多核加速），否则大项目索引极慢 - 搜索前务必等左下角显示 “Indexing… Done”，否则结果为空——Sublime 不像 VS Code，它不后台持续索引
最易被忽略的是：GUI 启动的 Sublime 从不加载 ~/.zshrc，哪怕你在那里写了十年 PATH；所有构建、跳转、语法高亮的问题，根源都在这个启动隔离上。一旦 PATH 没对，后面全是徒劳。
