关闭Go相关进程并清除缓存;2. 删除各系统默认安装目录:Windows删C:\Go,macOS和Linux执行sudo rm -rf /usr/local/go;3. 清理环境变量与用户配置文件。

Go语言环境安装出错时,直接覆盖安装可能无法彻底解决问题。想要干净地重装Golang,必须完整卸载旧版本并清理残留配置。以下是适用于Windows、macOS和Linux的Golang彻底卸载与重装完整流程。
1. 停止相关进程与服务
在卸载前,关闭所有正在运行的Go程序或依赖Go的开发工具(如VS Code、GoLand等)。
如果你在使用Go模块代理或本地缓存服务,也建议一并停止:
- 清除Go缓存:执行 go clean -modcache(如果还能运行)
- 关闭IDE后台Go进程:检查任务管理器或活动监视器中是否有go、gopls等进程
2. 删除Go安装目录
Go通常以单目录方式安装,删除主目录即可移除核心文件。
立即学习“go语言免费学习笔记(深入)”;
- Windows:默认路径为 C:\Go,直接删除该文件夹
-
macOS:若通过官方pkg安装,路径为 /usr/local/go,执行:
sudo rm -rf /usr/local/go -
Linux:同样多位于 /usr/local/go 或 环境变量
Go依赖GOROOT、GOBIN、PATH等环境变量,卸载后必须清除。
-
Windows:
- 打开“系统属性 → 高级 → 环境变量”
- 在“系统变量”中删除:GOROOT、GOBIN(如有)
- 在PATH中移除所有包含Go或\Go\bin的条目
-
macOS/Linux:
- 编辑shell配置文件(如~/.zshrc、~/.bash_profile)
- 删除类似以下内容:
export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin - 保存后执行:source ~/.zshrc(根据实际文件名调整)
4. 删除用户模块与缓存目录
Go会生成模块缓存和构建临时文件,这些不会随主程序删除。
- 模块缓存:~/go(默认工作区,可手动备份后再删)
- 构建缓存:~/Library/Caches/go-build(macOS)或 ~/.cache/go-build(Linux)
- 模块下载缓存:~/go/pkg 和 ~/go/bin(若不再需要已下载包)
执行清理命令(以Linux/macOS为例):
rm -rf ~/go ~/Library/Caches/go-build ~/.cache/go-build5. 重新下载并安装Go
前往https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd下载最新稳定版安装包。
- Windows:推荐使用.msi安装包,自动配置环境变量
- macOS:使用.pkg安装包或解压tar.gz到/usr/local/go
-
Linux:下载tar.gz,解压并设置权限:
tar -C /usr/local -xzf go*.tar.gz
6. 配置环境变量(新安装)
确保以下变量正确设置:
- GOROOT:Go安装根目录,如/usr/local/go
- PATH:添加$GOROOT/bin到PATH
- GOBIN(可选):若自定义二进制输出路径,设置并加入PATH
示例(写入~/.zshrc):
export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin
export GOPATH=$HOME/go7. 验证安装
重启终端,执行以下命令确认安装成功:
go version应输出类似:
go version go1.22.0 darwin/amd64再运行:
go env检查GOROOT、GOPATH是否正确。
基本上就这些。只要按顺序清理干净,重装Golang很少再出问题。关键是别漏掉环境变量和用户缓存目录。不复杂但容易忽略。
-
Windows:










