安装Homebrew遇fatal错误及brew命令未找到问题求助

问题根源 #

• fatal: couldn't find remote ref refs/heads/master是因为dart-lang的Homebrew仓库已将默认分支从master改为main，旧的tap分支指向失效。
• brew: command not found是因为Homebrew安装未完成，其所在路径未添加到Shell环境变量PATH中。

分步解决 #

1. 临时配置PATH，让终端识别brew命令
   针对Apple Silicon芯片Mac的Homebrew路径/opt/homebrew，先临时将brew所在目录加入PATH：

   export PATH=/opt/homebrew/bin:$PATH
   

   执行后终端即可临时调用brew命令。

2. 修复dart-lang的tap分支问题
   两种可选方法，选其一即可：

   • 方法一：重新添加tap
     移除失效的旧tap后重新添加：

     brew untap dart-lang/dart
     brew tap dart-lang/dart
     

   • 方法二：手动修改git分支指向
     进入tap本地仓库目录，切换到新默认分支并关联远程：

     cd /opt/homebrew/Library/Taps/dart-lang/homebrew-dart
     git checkout main
     git branch -u origin/main main
     

3. 继续完成Homebrew安装
   执行中断的更新命令完成安装：

   brew update --force --quiet
   

   若仍有问题，直接重新运行Homebrew安装脚本：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

4. 永久配置PATH，避免后续问题
   打开zsh配置文件：

   open ~/.zshrc
   

   在文件末尾添加一行：

   export PATH=/opt/homebrew/bin:$PATH
   

   保存后执行以下命令让配置立即生效：

   source ~/.zshrc
   

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