Homebrew安装卸载软件时报错ruby@2.7 is not a valid keg怎么办

你已确认/usr/local/opt下的ruby@2.7软链接本身配置正常，该错误还有以下几种常见诱因：

• 软链接指向的目标路径不存在/损坏
  软链接本身配置正常不代表指向的目标路径真实存在，你可以执行以下命令验证目标路径是否有效：

ls -ld /usr/local/Cellar/ruby@2.7/2.7.4

如果命令返回无此文件或目录，说明该软链接为悬空链接，Homebrew无法读取到实际安装文件就会报错。

• 目标目录权限不符合Homebrew要求
  就算目标路径存在，若目录的读写执行权限配置异常，Homebrew没有权限读取目录内容也会判定其不是有效keg。你可以执行brew doctor命令，工具会自动扫描并提示权限相关的异常问题。

• ruby@2.7的安装元数据缺失
  Homebrew依赖keg目录下的INSTALL_RECEIPT.json元文件识别合法安装包，若之前的安装过程中断、或者手动删除过该文件，就算目录结构完整也会触发该报错。你可以检查目标目录下是否存在该文件来验证这个问题。

• Homebrew内部索引异常
  Homebrew本地缓存、索引损坏也可能导致合法keg被误判，你可以先执行brew update-reset重置Homebrew的本地状态后再尝试操作。

通用解决方案 #

如果排查后定位不到具体原因，可以直接执行以下命令重装ruby@2.7修复问题：

brew uninstall --force ruby@2.7
brew install ruby@2.7

如果重装过程中出现权限报错，按brew doctor的提示修复对应目录的权限即可。

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