MacOS下如何彻底卸载Rails 7.1.2？求解矛盾问题

问题原因 #

rails -v能显示版本但gem uninstall rails提示未安装，通常是因为rails命令并非来自全局gem，而是通过版本管理器（rbenv/rvm）、项目本地bundle或系统预装方式安装的，不在当前gem环境的管理范围内。

排查与卸载步骤 #

1. 定位rails命令的实际路径
   执行以下命令找到rails的位置：

   which rails
   

   根据输出的路径，对应不同场景处理：

2. 场景1：路径包含rbenv/rvm（版本管理器）

   • rbenv环境

     • 查看当前使用的Ruby版本：

       rbenv version
       

     • 卸载该Ruby版本下的Rails 7.1.2：

       rbenv exec gem uninstall rails -v 7.1.2
       

     • 若提示未安装，刷新rbenv的shim缓存：

       rbenv rehash
       

     • 彻底清理所有rbenv管理的Ruby版本中的Rails 7.1.2：

       for version in $(rbenv versions --bare); do
         rbenv exec gem uninstall rails -v 7.1.2 --all
       done
       

   • rvm环境

     • 查看当前Ruby gemset：

       rvm current
       

     • 卸载对应gemset里的Rails 7.1.2：

       rvm gemset use [gemset名称] && gem uninstall rails -v 7.1.2
       

     • 清理所有gemset中的Rails 7.1.2：

       rvm list rubies | grep -v '^=' | awk '{print $1}' | while read ruby; do
         rvm use $ruby
         rvm gemset list | grep -v '^=' | awk '{print $1}' | while read gemset; do
           rvm gemset use $gemset
           gem uninstall rails -v 7.1.2 --all
         done
       done
       

3. 场景2：路径为系统自带（如/usr/bin/rails）
   MacOS预装的Rails不在常规gem管理范围内，需手动清理：

   • 删除系统rails命令：

     sudo rm /usr/bin/rails
     

   • 删除Rails库文件（替换路径中的Ruby版本号为实际版本）：

     sudo rm -rf /Library/Ruby/Gems/2.6.0/gems/rails-7.1.2
     

   • 清理关联的bin文件：

     sudo rm /usr/bin/rake /usr/bin/rails
     

4. 场景3：rails命令来自项目本地bundle

   • 进入项目目录，确认是否为本地bundle安装：

     bundle exec rails -v
     

   • 移除项目本地的Rails 7.1.2：
     • 删除Gemfile.lock和vendor/bundle目录：

       rm Gemfile.lock && rm -rf vendor/bundle
       

     • 修改项目Gemfile中的Rails版本后，执行bundle update rails更新到目标版本，或直接移除Rails依赖（若项目不再需要）

验证卸载结果 #

执行以下命令确认卸载完成：

rails -v
gem list | grep rails

若rails -v提示命令不存在，或gem list无rails-7.1.2条目，说明卸载成功。

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