Ruby on Rails解析Gemfile报错 卸载sass后执行命令仍报错

安装sass后出现解析错误、卸载sass后错误不消失、任意命令都触发报错，核心原因是安装过程中损坏了项目Gemfile/Gemfile.lock配置，甚至污染了全局RubyGems配置，按以下步骤修复即可：

• 优先回滚配置：如果项目用了Git，直接在项目根目录执行git checkout Gemfile Gemfile.lock，一键恢复到安装sass之前的正常配置版本，这是效率最高的修复方式。
• 手动排查Gemfile错误：如果没有Git版本记录，直接打开项目根目录的Gemfile文件，逐行检查安装sass时自动追加的内容，常见错误包括gem声明缺引号、版本号格式非法、多余的空行或特殊字符，把所有格式错误的sass相关残留行全部删除，保存文件。
• 修复全局命令报错问题：如果非项目目录下执行命令也报错，说明全局Gem配置被污染，依次执行以下命令清理：

  # 卸载所有全局安装的sass相关包，提示时选择全部版本卸载
  gem uninstall sass sass-rails sassc
  # 清理无效的依赖缓存
  bundle clean --force
  

• 验证修复：回到项目根目录执行bundle install重新拉取合法依赖，之后执行rails -v、bundle list等常规命令，没有解析报错即修复完成。

后续安装sass类依赖不要直接全局执行gem安装，在项目Gemfile中明确声明依赖（例如gem 'sassc-rails'）后再执行bundle install，避免配置被异常篡改。

内容的提问来源于stack exchange，提问作者B05999