sublime text里ruby自动补全默认不工作，因其原生无ruby符号索引能力，f12和ctrl+space仅识别当前文件内符号；rails项目中helper、concern等分散目录需依赖sublimecodeintel与rubytest插件协同：前者负责显示补全，后者主动索引app/、lib/等路径，并须在.sublime-project中显式配置多目录及ruby_binary绝对路径，同时确保.rb语法正确绑定与.codeintel缓存及时更新。
Sublime Text里Ruby自动补全为什么默认不工作
因为Sublime Text原生不带Ruby符号索引能力，Go to Definition（F12）和Auto Complete（Ctrl+Space）默认只识别当前文件内的变量和方法。Rails项目里常见 helper、concern、engine 中的方法分散在不同目录，不额外配置就根本找不到——这不是插件没装，是Sublime压根没扫描那些路径。
必须装的两个插件：SublimeCodeIntel + RubyTest
别堆一堆废弃插件，这两个是2026年仍稳定支持ST4、且解决真实补全痛点的核心：
-
SublimeCodeIntel提供基础跳转与补全，但对Rails路径感知弱，需配合项目配置 -
RubyTest不是用来跑测试的，它会主动索引app/、lib/、config/initializers/下的所有.rb文件，大幅提升方法发现率 - 两者共存时，
RubyTest负责“找得到”，SublimeCodeIntel负责“显示出来”
关键：.sublime-project里必须写死索引路径
光装插件没用，RubyTest默认只扫项目根目录，遇到vendor/gems/my_engine或plugins/xxx这种结构就直接忽略。得手动告诉它：
{
"folders": [
{ "path": "." },
{ "path": "vendor/gems/my_engine" },
{ "path": "plugins/payments" }
],
"settings": {
"index_files": true,
"index_workers": 4,
"ruby_test_ruby_path": "/Users/xxx/.rbenv/shims/ruby"
}
}
注意三点：
-
"index_files": true必须显式开启，否则RubyTest不启动后台索引 -
ruby_test_ruby_path要填绝对路径，~不解析；如果你用rbenv，就填/Users/xxx/.rbenv/shims/ruby - 索引完成前左下角会显示
Indexing…，此时按Ctrl+R搜方法名结果为空，得等它消失
补全失效时先查这三处
补全突然变少或F12跳错，大概率不是插件坏了，而是环境断连：
- 检查
View → Show Console里有没有SublimeCodeIntel报ruby not found——说明它调用的ruby命令不在PATH里，得在Preferences → Package Settings → SublimeCodeIntel → Settings里配"ruby_binary": "/Users/xxx/.rbenv/shims/ruby" -
.rb文件右下角显示Plain Text？补全完全不会触发，必须点它→选Ruby→再点Open all with current extension as… - 刚加了新
app/models/concerns/目录但补全没反应？删掉项目根目录下的.codeintel/缓存文件夹，重启Sublime强制重索引
补全依赖的是本地符号数据库，不是实时解析，任何路径变更、Ruby版本切换、插件更新后，缓存都可能滞后——别信“装完就自动好”，该删缓存就删，该等索引就等。
