gvm是类Unix系统下最稳妥的Go多版本管理工具,能隔离版本、避免PATH污染;安装后需重载shell配置(如source ~/.profile)否则go命令不可用。

用 gvm 安装多版本 Go 并设为默认
gvm(Go Version Manager)是类 Unix 系统下最稳妥的 Go 自动化安装工具,能隔离版本、避免污染系统 PATH,比手动下载解压 + 修改 ~/.bashrc 更可靠。
常见错误是直接用 curl 脚本一键装却忽略 shell 初始化:装完不重载配置或没执行 source,导致 go version 仍报 command not found。
- 执行
bash <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
后,必须运行source ~/.gvm/scripts/gvm - 接着用
gvm install go1.21.6(推荐 LTS 版本),再用gvm use go1.21.6 --default设为全局默认 - 验证:新开终端后运行
go version,输出应含go1.21.6;which go应指向~/.gvm/versions/go1.21.6.linux.amd64/bin/go
Linux 下用脚本免交互安装 Go(无 gvm 依赖)
某些 CI 环境或最小化容器中无法装 gvm,此时需纯脚本下载、解压、写入环境变量。关键点在于:路径硬编码易出错,且 /etc/profile 不一定被非登录 shell 读取。
推荐做法是把 Go 二进制目录加到 $HOME/.profile(对用户生效)或 /etc/environment(系统级,但只支持 KEY=VALUE 格式,不执行命令)。
立即学习“go语言免费学习笔记(深入)”;
- 下载地址需匹配架构:用
uname -m判断是amd64还是arm64,对应下载go1.21.6.linux-amd64.tar.gz或go1.21.6.linux-arm64.tar.gz - 解压后建议放在
/usr/local/go(标准路径),然后向$HOME/.profile追加:echo 'export GOROOT=/usr/local/go' >> $HOME/.profile echo 'export PATH=$GOROOT/bin:$PATH' >> $HOME/.profile source $HOME/.profile
- 注意:不要用
sudo echo ... >> /etc/profile—— 重定向由当前 shell 执行,权限无效;应改用sudo tee -a /etc/profile
macOS 上用 homebrew 自动装 Go 并规避 SIP 权限问题
brew install go 表面简单,但 macOS Sonoma 及更新版本启用严格 SIP(System Integrity Protection),若之前手动改过 /usr/local 权限或用过旧版 Homebrew,常出现 Permission denied 或 brew link go 失败。
根本原因是 Homebrew 默认将 Go 装在 /opt/homebrew/Cellar/go/1.21.6/bin/go,再 symlink 到 /opt/homebrew/bin/go;而 shell 的 PATH 若未包含该路径,就找不到命令。
- 先确认 Homebrew 安装路径:
brew --prefix,输出通常是/opt/homebrew(Apple Silicon)或/usr/local(Intel) - 确保
$HOME/.zshrc包含:echo 'export PATH="'$(brew --prefix)'/bin:$PATH"' >> $HOME/.zshrc source $HOME/.zshrc
- 若已装过 Go 且
brew link go报错,先运行brew unlink go && brew link go;如提示 “Could not symlink”,说明目标路径被占用,用ls -la $(brew --prefix)/bin/go检查是否为残留软链
Windows PowerShell 脚本静默安装 Go(绕过 GUI 和 UAC 弹窗)
PowerShell 脚本调用官方 MSI 安装包时,默认会弹出 UI 界面并卡在 UAC 提示,无法用于无人值守部署。必须用 msiexec 静默参数,并预设安装路径与环境变量选项。
MSI 的 ADDLOCAL 属性控制组件安装,GO_INSTALL_PATH 决定根目录;但 Windows 10/11 默认关闭“系统环境变量自动刷新”,装完需手动重启终端或调用 RefreshEnvironment。
- 下载
go1.21.6.windows-amd64.msi后,用以下命令静默安装:msiexec /i go1.21.6.windows-amd64.msi /quiet ADDLOCAL=GoRuntime,GoCompiler,GoDocumentation GO_INSTALL_PATH=C:\Go
- 安装完成后,PowerShell 中需重新加载环境变量:
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User") - 验证:
go version应返回版本号;$env:GOROOT若为空,说明 MSI 未自动设该变量——需脚本补上:[System.Environment]::SetEnvironmentVariable("GOROOT", "C:\Go", "Machine")










