终端无法执行gem install debug等命令的排查求助

• 检查Gem源配置
  执行gem sources查看当前使用的源，部分源可能存在访问缓慢或失效的情况，导致命令卡住。若使用默认的rubygems.org，可尝试切换至国内镜像源，操作命令如下：

  gem sources --remove https://rubygems.org/
  gem sources --add https://gems.ruby-china.com/
  

  切换完成后重试相关Gem命令。

• 验证Ruby环境与权限

  • 执行ruby -v和gem env确认Ruby版本及Gem安装路径是否正常，排查路径配置错误问题。
  • 检查Gem安装目录的权限：ls -ld $(gem environment gemdir)，确保当前用户拥有该目录的读写权限。若使用rbenv、rvm等版本管理工具，重新执行初始化命令（如rbenv init或source ~/.rvm/scripts/rvm），确保环境变量加载正确。

• 查看Gem命令详细日志
  给Gem命令添加--verbose参数，例如gem install debug --verbose，通过详细输出定位命令卡住的具体环节；也可添加--backtrace参数，若命令报错，能获取完整调用栈辅助排查。

• 排查网络与代理问题

  • 用curl https://rubygems.org/测试能否正常访问Gem源地址，若无法访问，说明网络存在问题。
  • 暂时关闭系统代理或VPN后重试命令，部分代理会干扰Gem的网络请求流程。

• 清理Gem缓存
  执行gem cleanup清理过期缓存，或手动删除缓存目录（通常为~/.gem/cache），避免缓存文件损坏导致命令卡住，之后重试相关操作。

• 测试Ruby网络功能
  编写简单脚本测试Ruby网络模块是否正常：

  require 'net/http'
  uri = URI('https://rubygems.org/')
  response = Net::HTTP.get_response(uri)
  puts response.code
  

  运行脚本，若无法正常获取响应，说明Ruby网络模块存在问题，可尝试重新安装Ruby。

• 跟踪进程状态
  当Gem命令卡住时，在另一个终端执行ps aux | grep gem查看进程状态；Linux/macOS用户可使用strace gem install debug跟踪系统调用，定位进程卡住的系统操作环节（如等待网络响应、文件锁等）。

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