Sublime启动后找不到ruby/rails命令是因为GUI进程未加载shell配置；Mac用户应修改~/.zprofile添加PATH，Windows需将Ruby路径加入系统环境变量，并通过控制台验证PATH是否包含Ruby路径。
Sublime 启动后找不到 ruby/rails 命令？PATH 没被 GUI 进程读取
终端里 ruby -v 和 rails -v 都正常，但 Sublime 按 Ctrl+B 就报 /bin/sh: ruby: command not found，本质是 GUI 应用（如 Dock 点开的 Sublime）不加载你的 shell 配置文件（~/.zshrc 或 ~/.bashrc），只读 ~/.zprofile（macOS）或系统级 PATH（Windows）。
- Mac 用户：在
~/.zprofile末尾加一行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 路径
.erb 文件显示为 Plain Text？必须手动绑定语法
Sublime 不会自动识别 app/views/layouts/application.html.erb 是 Rails 模板，默认可能显示为 “Plain Text” 或 “HTML”，导致 ERB 标签无高亮、无补全、无折叠。
- 临时解决：打开该文件 → View → Syntax → Ruby on Rails → HTML (Rails)
- 永久绑定：右键编辑区右下角语法名 → Set Syntax as Default for this Extension → 输入
erb确认 - 若项目用
.slim或.haml，需单独安装Slim或Haml插件，且安装后必须重启 Sublime 才生效
想在 Sublime 里跑 rails server？别用 Build System
Build System 是为短命命令设计的（比如 ruby -c），强行塞进 rails server 会导致 Sublime 卡死、进程无法终止、端口被占住，甚至需要 kill -9。
- 开发阶段最稳做法：终端执行
cd myapp && rails server，Sublime 只管写代码 - 真要嵌入终端：装
Terminus插件（通过 Package Control），Ctrl+Shift+P→Terminus: Open Default Shell，再输bin/rails s - 避免用
SublimeREPL跑bin/rails c——它不支持 TTY，irb提示符会卡住不动
F12 跳转不准？Rails 方法分散 + Sublime 索引能力有限
Sublime 没有 RubyMine 那种全项目符号解析能力，F12 跳转在跨 helpers、concerns、engines 或 lib/ 时大概率失效，这不是插件问题，是编辑器定位机制的天然限制。
- 提升准确率的关键动作：在项目根目录建
.sublime-project文件，显式启用索引并包含所有相关路径，例如：{ "folders": [ { "path": "." }, { "path": "lib" }, { "path": "vendor/gems/my_engine" } ], "settings": { "index_files": true, "index_workers": 4 } } - 使用
Ctrl+R（Win/Linux）或Cmd+R（Mac）搜方法前，等左下角出现 “Indexing…” 完成，否则结果不全 - 跳转失败时，优先查
RubyTest插件是否已装——它能增强对lib/和test/下 Ruby 文件的索引覆盖
真正卡住人的从来不是“能不能配”，而是 PATH 加载时机、语法绑定动作、索引路径显式声明这三处——它们不报错，但会让所有高级功能静默失效。配置完记得关掉所有 Sublime 实例再重开，别信“改完就生效”。
