Go语言版本管理分编译器和项目依赖两层：用go install golang.org/dl/go1.26@latest安装多版本编译器（如go1.26），通过alias或函数切换；项目依赖由go.mod和go.sum锁定，需go mod tidy同步、禁止手动修改vendor，私有仓库须配置GOPRIVATE。
Go 语言版本管理分两层：编译器（go 命令本身）和项目依赖（go.mod）。别混为一谈，也别指望一个工具搞定全部。
怎么装多个 Go 编译器版本（Windows/macOS/Linux 通用）
官方推荐用 go install golang.org/dl/go1.26@latest 安装特定版本，再执行 go1.26 download。它不改系统 go，而是生成带版本号的命令（如 go1.26），干净、无副作用。
常见错误现象：go version 仍显示旧版 —— 很可能你没运行 go1.26 download，或误以为安装完就自动替换了 go 命令。
- Linux/macOS 下可 alias 快速切换：
alias go=go1.26 - Windows PowerShell 中建议用函数封装：
function go { go1.26 @args } - 别碰
GOROOT手动设置，go1.x命令会自己处理路径 - CI/CD 或 Docker 构建中，直接下载预编译二进制包（如
https://go.dev/dl/go1.26.windows-amd64.msi）比调用go install更稳
为什么不用 gvm（尤其在 macOS/Linux 上）
gvm 默认从源码编译，失败率高——不是网络问题，是缺 gcc、make 或 Xcode CLI 工具。macOS 上 xcode-select --install 没跑，gvm install 必卡住。
立即学习“go语言免费学习笔记（深入）”；
更隐蔽的坑：gvm use 后 which go 还指向 /usr/local/bin/go？大概率是 shell 配置没生效，或 Homebrew 的 go 在 $PATH 里优先级更高。
- 检查污染：
env | grep -i '^go'，删掉手动写的GOROOT、GOBIN -
gvm list显示已安装，但gvm list known才能看到所有可用版本（含 RC） - CI 环境里禁用
gvm：它依赖用户目录写入、交互式 shell 初始化，和容器不可变原则冲突
项目依赖版本怎么锁死（go.mod 不是摆设）
go mod tidy 会自动写入依赖版本，但真正起作用的是 go.sum 文件。它记录每个 module 的校验和，防止依赖被篡改或替换。
容易踩的坑：go mod vendor 后还手动改 vendor/ 里的代码 —— 下次 go mod tidy 会把你的修改冲掉，且 go.sum 校验失败。
- 升级某个依赖时，用
go get example.com/lib@v1.4.2，别直接改go.mod里的版本号 - 私有仓库需配
go env -w GOPRIVATE=git.example.com/*，否则go get会走 proxy 并失败 - 团队协作时，
go.mod和go.sum必须一起提交，缺一不可
Gin 接口版本管理该用哪条路（别被“灵活”忽悠）
URL 路径带版本号（/v1/users）是唯一经得起生产考验的方式。别用 X-API-Version header，Ingress 默认不透传；也别用 ?version=v2，OpenAPI 工具无法识别，Prometheus metrics 会混掉。
翻车最多的地方：在同一个 handler 里用 if version == "v2" 分支 —— v1/v2 逻辑耦合，灰度发布、单独回滚、独立监控全失效。
- 用
v1 := r.Group("/v1")和v2 := r.Group("/v2")显式分组 - handler 函数名别带版本后缀（如
GetUserV2），靠路由分发，不是靠名字暗示行为 - 每个版本用独立 struct（
UserRespV1/UserRespV2），字段增减必须隔离，别靠json:",omitempty"临时应付 - v1 下线前，
GET /v1/*应返回410 Gone并带X-API-Deprecated: true响应头
最常被忽略的一点：版本管理不是“加个路径前缀”就完事。它牵扯到路由注册顺序、中间件挂载位置、DTO 结构体定义粒度、甚至 OpenAPI 文档生成方式。任何一个环节松动，都会让“v2 上线”变成线上事故倒计时。
