升级Go项目至1.22遇toolchain not available错误，所有Go命令失效

1. 彻底清理Go相关缓存与配置残留 #

• 删除Go工具链缓存目录：

  rm -rf ~/Library/Caches/go
  rm -rf ~/Library/Caches/go-build
  

• 删除Go全局配置文件：

  rm -rf ~/.config/go
  

• 检查.zshrc、.bashrc、.bash_profile等shell配置文件，删除其中手动设置的GOTOOLCHAIN、GOROOT、GOPATH相关行，修改后重启终端。

2. 完全卸载现有Go版本 #

• 官方安装包安装的Go，执行卸载命令：

  sudo rm -rf /usr/local/go
  sudo rm /etc/paths.d/go
  

• 手动删除自定义安装路径下的Go残留目录。

3. 重新安装目标Go版本 #

• 下载对应平台的官方安装包（如Go 1.22.0或1.21.10）完成安装，验证PATH配置：

  echo $PATH | grep "/usr/local/go/bin"
  

  确保/usr/local/go/bin在PATH列表中，若未存在则手动添加到shell配置文件并重启终端。

4. 修复项目配置与工具链设置 #

• 若使用Go 1.22，先验证安装：

  go version
  

  确认输出为目标版本后，指定具体工具链版本（避免模糊版本号导致下载失败）：

  go env -w GOTOOLCHAIN=go1.22.0
  

• 若回退到Go 1.21，修改项目根目录go.mod文件第一行为go 1.21，同时删除可能存在的go.work文件（若有）。

5. 验证Go命令恢复正常 #

运行go mod tidy或go test等命令，确认不再触发工具链下载错误。

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