Sublime启动时找不到rails或bundle命令的根本原因是未加载shell环境变量（如rbenv shim路径或rvm gemset），导致插件调用失败；必须通过终端启动Sublime（macOS/Linux用subl .，Windows确保PATH包含ruby/bin和msys64/usr/bin），并验证which rails输出是否正确。
Sublime 启动时找不到 rails 或 bundle 命令
根本原因是 Sublime 没加载 shell 的环境变量（比如 rbenv 的 shim 路径或 rvm 的 gemset），导致插件调用命令失败。直接在终端里 which rails 有输出，但 Sublime 构建系统报 command not found，就是这个症状。
必须用终端启动 Sublime：
- macOS：确保已配置
subl命令，然后在项目根目录运行subl . - Linux：同样从已 source 过
~/.zshrc或~/.bashrc的终端中执行subl . - Windows：确认
ruby/bin和msys64/usr/bin在系统PATH中
验证方式：新建构建系统 Ruby on Rails.sublime-build，内容为：
{ "shell_cmd": "which rails", "working_dir": "$project_path" }按 Cmd+B（macOS）或 Ctrl+B（Win/Linux），输出应为类似 /Users/xxx/.rbenv/shims/rails 的路径。
生成控制器/模型时插件不识别当前项目上下文
RailsGenerator 或 Rails Tools 插件在右键菜单或命令面板里调用 rails g controller 时，如果提示 No Rails app detected 或报错找不到 config/application.rb，说明插件没定位到项目根目录。
关键动作不是“重装插件”，而是确保：
- 项目是通过
Add Folder to Project加入的，且该文件夹内包含config/routes.rb和config/application.rb - 不要只打开单个
.rb文件——那样 Sublime 不会识别为 Rails 项目 - 检查
Project → Edit Project中是否显式设置了"folders": [{ "path": "." }]，路径必须是绝对路径或相对于当前窗口的正确相对路径
部分插件（如旧版 Ruby Slim）会因 Rails 7+ 的 importmap 或 jsbundling-rails 结构误判项目类型，建议优先选用仍在维护的 Rails Tools（作者 tekknolagi）或 SublimeRuby（作者 guillermooo）。
Ctrl+Click 跳转到模型/控制器总是失败
Rails 的动态方法（belongs_to、has_many、delegate、helper 方法等）天然无法被静态分析工具识别，这不是你配置错了，是框架设计如此。
能做的有限提升包括：
- 安装
CTags插件，并在项目根目录运行：ctags -R --fields=+niaz --languages=ruby .
之后F12或Ctrl+Click才能跳转到类定义和显式声明的方法 - 启用
RubyTest（现名SublimeRuby）的索引功能，在Preferences → Package Settings → SublimeRuby → Settings中设"index_files": true - 在
.sublime-project里手动补全引擎或挂载引擎路径，例如："folders": [ { "path": "." }, { "path": "engines/my_engine" } ]
别指望跳转 100% 准确——form_with 生成的实例方法、ActiveRecord::Base 继承链上的方法、甚至 ApplicationController 里 before_action 引入的私有方法，都基本不可跳转。这时候老实用 Cmd+Shift+P → Rails: Go to Model 更靠谱。
ERB 模板里
默认语法高亮对 .erb 文件支持薄弱，常表现为标签配对错位、嵌套层级混乱、 后不自动补全 <code>%>。
解决路径很明确：
- 安装
ERB Insert Snippets：输入form回车即得，支持link、image、render等常用片段 - 禁用默认 HTML 语法，手动将
.erb关联到Ruby on Rails语法：右键 →Change Syntax → Ruby on Rails（该语法包随Rails Tools自动安装） - 避免同时启用多个 ERB 插件（如
ERB Insert and Toggle+ERB Insert Snippets），它们可能冲突导致快捷键失效
注意：若项目用了 slim 或 haml，需单独安装对应语法插件（如 Slim），但不要指望它们和 ERB 插件共存时互相兼容——切换文件类型时手动换语法更稳。
