在 Debian 上升级 Golang 的常用方式
- 使用系统仓库的 apt（稳定但版本通常较旧）
- 手动安装官方二进制包（版本新、可控性强）
- 使用版本管理工具（gvm、asdf、goenv，便于多版本切换）
- 使用 update-alternatives 进行系统级切换（适合多版本并存与快速切换）
方式一 使用系统仓库升级
- 更新索引并升级已安装的 golang 包：
- sudo apt update
- sudo apt install --only-upgrade golang
- 验证：go version
- 说明：Debian 稳定版的仓库通常滞后于官方发布，如需新特性或安全补丁，优先考虑后几种方式。
方式二 手动安装官方二进制包
- 准备与备份
- 查看现有版本：go version
- 备份旧版（若之前是手动安装到 /usr/local/go）：sudo mv /usr/local/go /usr/local/go.bak
- 下载与安装
- 前往官方下载页获取对应架构的包，例如：wget https://dl.google.com/go/go1.22.0.linux-amd64.tar.gz
- 解压到系统目录：sudo tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
- 配置环境变量（写入你的 shell 配置，如 ~/.bashrc、~/.zshrc 或 ~/.profile）
- echo ‘export PATH=$PATH:/usr/local/go/bin’ >> ~/.bashrc
- source ~/.bashrc
- 验证：go version
- 提示：请将示例版本号替换为当前所需版本；如使用非 amd64 架构，请下载对应架构的包。
方式三 使用版本管理工具
- gvm（Go Version Manager）
- 安装：bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer.sh)
- 在 ~/.bashrc 或 ~/.zshrc 中加入：[[ -s “$HOME/.gvm/scripts/gvm” ]] && source “$HOME/.gvm/scripts/gvm”
- 常用：gvm listall；gvm install go1.22.0；gvm use go1.22.0 --default
- asdf
- 安装 asdf 后添加 golang 插件：asdf plugin-add golang https://github.com/asdf-vm/asdf-golang.git
- 常用：asdf install golang 1.22.0；asdf global golang 1.22.0（或 asdf local golang 1.22.0）
- goenv
- 安装 goenv 后：goenv install 1.22.0；goenv global 1.22.0（或 goenv local 1.22.0）
- 适合需要在同一台机器上维护多个 Go 版本的开发场景。
方式四 使用 update-alternatives 进行系统级切换
- 安装多个版本后（如 /usr/local/go1.21 与 /usr/local/go1.22），注册到 alternatives：
- sudo update-alternatives --install /usr/bin/go go /usr/local/go1.21/bin/go 10
- sudo update-alternatives --install /usr/bin/go go /usr/local/go1.22/bin/go 20
- sudo update-alternatives --install /usr/bin/gofmt gofmt /usr/local/go1.21/bin/gofmt 10
- sudo update-alternatives --install /usr/bin/gofmt gofmt /usr/local/go1.22/bin/gofmt 20
- 切换版本：sudo update-alternatives --config go（以及 --config gofmt）
- 验证：go version；gofmt -version
- 适合系统级统一版本管理，便于脚本与 CI 环境使用。
验证与常见问题处理
- 验证命令
- go version
- go env GOROOT GOPATH
- 常见问题
- 命令未找到：检查 PATH 是否包含 /usr/local/go/bin；确认使用的 shell 配置文件（~/.bashrc、~/.zshrc、~/.profile）已 source 生效。
- 多版本并存冲突：优先使用版本管理工具或 update-alternatives；避免同时设置多个 GOROOT。
- 权限问题：解压到 /usr/local 需要 sudo；若希望用户级安装，可将 Go 解压到 $HOME/.local/go 并把 $HOME/.local/go/bin 加入 PATH。