go模块v2升级必须修改module路径为github.com/user/repo/v2并同步更新所有import语句，否则仍被识别为v1；go get github.com/user/repo@v2.0.0必然失败，正确写法是go get github.com/user/repo/v2@v2.0.0或go get ./v2，且需确保tag打在v2/子目录对应commit上。
用 go get package@version 直接安装指定版本
这是最常用也最直接的方式，Go 会自动更新 go.mod 和 go.sum，适合日常开发中快速引入或切换版本。
- 命令格式必须是
go get github.com/user/repo@v1.2.3，@后不能带空格，版本号大小写敏感（比如v1.9.1不是V1.9.1） - 支持多种后缀：
@latest（最新 tagged 版）、@master（实际是 pseudo-version，不是真实分支）、@abc123（commit hash）、@v0.0.0-20230101000000-abcdef123456（时间戳式伪版本） - 如果报
unknown revision，大概率是版本名拼错、该 tag 不存在、或模块路径在go.mod里声明的不一致（比如多了/v2后缀） - 执行后不会立即下载源码到项目目录，而是解压进
$GOPATH/pkg/mod缓存；后续go build才真正参与构建
手动改 go.mod 再 go mod tidy
适合批量调整、CI/CD 中固化依赖，或你想完全掌控 go.mod 内容时使用。
- 直接编辑
go.mod，把某行改成类似require github.com/sirupsen/logrus v1.9.0，注意路径和版本之间只有一个空格 - 保存后运行
go mod tidy—— 它会拉取对应版本、校验哈希、清理未使用的require行，并写入go.sum - 不要跳过
go mod tidy：只改go.mod不执行它，依赖不会真正下载，go build可能失败或拉取意外版本 - 如果
go mod tidy报no required module provides package，说明 import 路径和require声明的模块路径不匹配（常见于子模块路径错误或缺少/v2等后缀）
go mod download 只缓存不修改依赖图
这个命令不碰 go.mod 或 go.sum，纯粹预热本地缓存，适合离线环境或 CI 构建前准备。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 运行
go mod download（无参数）会下载go.mod中所有require的模块及其间接依赖 - 指定模块：如
go mod download github.com/gin-gonic/gin@v1.9.1，版本必须存在且可解析，否则报unknown revision - 它不会解决兼容性问题——比如你手动写了个不兼容的版本到
go.mod，go mod download照下不误，但后续go build仍可能因类型不匹配失败 - 配合
GOPROXY使用效果最好；若没设代理，国内用户常卡在golang.org/x/...上，此时需提前配置好镜像站
为什么设置了 GOPROXY 还是慢或失败？
单设 GOPROXY 不够，三个环境变量必须同时生效。
-
GO111MODULE=on：禁用 GOPATH 模式，否则go mod命令可能被忽略或退化行为 -
GOPROXY=https://goproxy.cn,direct：逗号分隔，direct是关键字，不是 URL；不能写成https://direct -
GOSUMDB=sum.golang.google.cn：国内可用的校验服务，设为off虽能跳过校验，但会失去完整性保护，不推荐 - 私有仓库要额外加
GONOPROXY=git.internal.company.com，否则镜像站会 404 或返回认证错误
最容易被忽略的是 GO111MODULE=on 和 GOSUMDB 的组合缺失——哪怕 go.mod 文件存在，没有前者，go get 可能静默走 GOPATH；没有后者，校验阶段会超时或拒绝写入 go.sum，导致后续命令反复重试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
