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
gvm 依赖)某些 CI 环境或最小化容器中无法装 gvm,此时需纯脚本下载、解压、写入环境变量。关键点在于:路径硬编码易出错,且 /etc/profile 不一定被非登录 shell 读取。
推荐做法是把 Go 二进制目录加到 $HOME/.profile(对用户生效)或 /etc/environment(系统级,但只支持 KEY=VALUE 格式,不执行命令)。
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
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 若未包含该路径,就找不到命令。
brew --prefix,输出通常是 /opt/homebrew(Apple Silicon)或 /usr/local(Intel)$HOME/.zshrc 包含:echo 'export PATH="'$(brew --prefix)'/bin:$PATH"' >> $HOME/.zshrc source $HOME/.zshrc
brew link go 报错,先运行 brew unlink go && brew link go;如提示 “Could not symlink”,说明目标路径被占用,用 ls -la $(brew --prefix)/bin/go 检查是否为残留软链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
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
go version 应返回版本号;$env:GOROOT 若为空,说明 MSI 未自动设该变量——需脚本补上:[System.Environment]::SetEnvironmentVariable("GOROOT", "C:\Go", "Machine")