atom已停止维护，autocomplete-ruby因依赖废弃模块、不兼容新版electron及ruby 3.x语法而基本不可用；推荐改用vs code+solargraph方案，支持ruby 3.0–3.3全特性。
Atom 已于 2022 年正式停止维护，atom.io 官网下线，所有插件仓库（包括 apm）不再更新、无法安装新插件，语法提示类插件如 autocomplete-ruby、ruby-block 等在新版 Electron（Atom 1.60+）上普遍失效，且无法兼容 Ruby 3.x 的语法特性（如解构赋值、模式匹配）。不建议新项目或长期维护项目继续使用 Atom 做 Ruby 开发。
为什么 autocomplete-ruby 在 Atom 中基本不可用
该插件依赖已废弃的 rspec-core 启动脚本和本地 ruby 进程做 AST 解析，实际运行时会频繁报错：
-
TypeError: Cannot read property 'length' of undefined（因 Atom 的 TextBuffer API 变更） -
Command failed: ruby -e require 'ripper'; puts Ripper.sexp('def a; end')（Ruby 3.1+ 默认禁用Ripper在沙箱中执行） - 不识别
def m(...)或case x in {a:}等新语法，直接跳过补全
如果必须用 Atom，可临时启用基础语法高亮与简单补全
仅限 Ruby 2.7 以下、Atom ≤ 1.58 的旧环境，步骤如下：
- 手动下载离线插件包：
apm install autocomplete-ruby@0.2.10（不要用--no-color，否则安装失败） - 关闭
core.useTreeSitterParsers（在 Settings → Core 中取消勾选），否则language-ruby会绕过传统 grammar - 在
config.cson中强制指定 Ruby 路径："autocomplete-ruby": "rubyPath": "/usr/local/bin/ruby" - 禁用
linter-rubocop和ruby-test——它们会与autocomplete-ruby抢占$LOAD_PATH导致崩溃
真正可用的 Ruby 语法提示替代方案
VS Code + solargraph 是目前最稳定的选择，它基于 Language Server Protocol（LSP），支持 Ruby 3.0–3.3 全部特性：
- 安装
solargraphgem：gem install solargraph（需 Ruby ≥ 2.6） - VS Code 安装官方扩展：
Solargraph（作者：Castwide） - 项目根目录运行：
solargraph bundle（自动解析Gemfile，生成 cache） - 打开
.rb文件后，Ctrl+Space即触发方法/变量补全，悬停显示类型签名
注意：solargraph 首次索引较慢，但后续响应在 100ms 内；若遇到 undefined method `to_h' for #<set></set>，说明用了旧版 yard，执行 gem update yard 即可。
