先确认 rubocop 命令是否已安装并可在 shell 中运行，再检查 VSCode 是否继承正确 PATH（尤其 rbenv/rvm 环境），确保设置中为 "ruby.formatter": "rubocop"（非 "ruby.format"），且 .rubocop.yml 位于项目根目录，最后重启 VSCode 窗口使配置生效。
rubocop 命令没找到：先确认是否真装上了
VSCode 里点保存没反应，大概率不是插件问题，而是 rubocop 这个命令压根不在你的 shell 环境里。VSCode 启动时会继承终端的 PATH，但如果你用的是 rbenv/rvm，或者 VSCode 是从桌面图标启动（没走 shell 初始化），rubocop 就可能找不到。
- 在 VSCode 集成终端里运行
which rubocop，如果返回空，说明没装或没生效 - 优先用 Bundler 安装：在项目根目录执行
bundle add rubocop --group development，再运行bundle exec rubocop --version确认可用 - 不推荐全局
gem install rubocop，尤其当项目用了不同 Ruby 版本或 rubocop 版本时，容易冲突 - 如果用 rbenv，确保 VSCode 终端加载了
~/.rbenv/bin；rvm 用户检查~/.rvm/bin是否在 PATH 中
VSCode 设置里写错字段名：ruby.formatter 不是 ruby.format
很多人复制网上旧教程，把配置项写成 "ruby.format": "rubocop"，这已经失效了。VSCode Ruby 扩展（v0.39+）只认 "ruby.formatter"，拼错、少字母、大小写不对都会让格式化静默失败。
- 打开项目级
.vscode/settings.json（比用户级设置更可靠），写入：
{
"ruby.formatter": "rubocop",
"editor.formatOnSave": true,
"editor.formatOnPaste": false
}
-
"ruby.formatter"的值只能是"rubocop"字符串，不能是路径或命令行参数 - 别同时开多个格式化器（比如又配了
"ruby.formatter": "rufo"），VSCode 不支持 fallback - 改完设置后，重启 VSCode 窗口（不只是重载窗口），否则新配置可能不加载
rubocop 配置文件缺失或路径不对：.rubocop.yml 必须在项目根目录
即使 rubocop 命令能跑，VSCode 也可能不按你预期的规则格式化——因为默认用的是全局配置，而你项目里自定义的 .rubocop.yml 没被识别。
- 在项目根目录运行
rubocop --init，生成基础.rubocop.yml - 确认该文件确实在
pwd输出的路径下，而不是子目录里；VSCode 不会向上递归查找 - 如果用 Bundler，确保
.rubocop.yml里有require: rubocop-rails这类扩展时，对应 gem 已加入 Gemfile 并bundle install过 - 想临时禁用某条规则？直接在代码行加注释：
# rubocop:disable Metrics/LineLength
保存时没触发格式化：检查 editor.formatOnSave 和文件关联
格式化“看起来没动”，常见原因是 VSCode 根本没把它当成 Ruby 文件来处理，或者自动格式化被其他设置压制了。
- 确认当前文件后缀是
.rb，且右下角状态栏显示语言模式为Ruby（不是 Plain Text 或 Ruby on Rails） - 检查有没有冲突设置，比如
"[ruby]": { "editor.formatOnSave": false }覆盖了全局设置 -
"editor.formatOnSave"必须是布尔值true，不能是字符串"true" - 如果只希望对特定文件生效（比如跳过
config.ru），可在.vscode/settings.json加：
"[ruby]": {
"editor.formatOnSave": true,
"files.exclude": { "**/config.ru": true }
}
真正卡住的地方，往往不是 RuboCop 本身多难配，而是 VSCode 没拿到它、没认出 Ruby 文件、或者根本没打算去调它——每一步都得亲手验证，不能靠“应该可以”。
