go框架本质是普通go模块，依赖管理统一通过go.mod记录、go get拉取、go build解析；无go.mod时go get不生效，需先go mod init；慎用go get -u，推荐精确版本控制如go get @v1.9.1；私有库需goproxy与goprivate配合；go.sum校验失败应清缓存而非手动修改。
Go 框架本身不是“安装后就能用”的黑盒，它只是普通 Go 模块；依赖管理方式和任何第三方包完全一致——靠 go.mod 记录、go get 拉取、go build 解析。不存在“框架专属依赖流程”，混淆这点是多数人踩坑的起点。
go get github.com/gin-gonic/gin 不生效？检查是否在 module 模式下
常见现象：执行 go get github.com/gin-gonic/gin 后，go.mod 没更新，代码里 import "github.com/gin-gonic/gin" 仍报错 “no required module provides package”。
- 根本原因：当前目录没有
go.mod文件，且GO111MODULE环境变量为auto（默认）时，Go 会退回到 GOPATH 模式，把包下到$GOPATH/src/，但不会写入项目本地依赖记录 - 确认方式：运行
go env GO111MODULE和ls go.mod；若无go.mod，先执行go mod init example.com/myapp（模块路径必须是合法导入路径，不能是./myapp） - 补救操作：初始化后，再运行
go get github.com/gin-gonic/gin或直接go run main.go（只要代码里有 import，构建时就会自动拉取并写入go.mod）
为什么 go get -u 升级后程序崩了？慎用无约束升级
go get -u 会递归升级所有直接依赖及其间接依赖到最新 minor/patch 版本，极易触发不兼容变更（比如 Gin v1.9 → v1.10 改了中间件签名，或 logrus v1.8 → v1.9 移除了某个方法）。
- 安全做法：升级前先看目标包的 CHANGELOG 或 GitHub Releases，确认 breaking change
- 精确控制：用
go get github.com/gin-gonic/gin@v1.9.1锁定版本；或用go get github.com/gin-gonic/gin@latest获取最新 tagged 版本（跳过未打 tag 的 commit） - 降级同理：直接
go get github.com/gin-gonic/gin@v1.8.2，Go 会覆盖go.mod中原有条目 - 验证效果：升级/降级后务必运行
go mod tidy，它会删掉未被引用的依赖，并补全缺失的间接依赖
私有 Git 仓库依赖拉不下来？GOPROXY 和 GOPRIVATE 必须配对
错误信息常为：go get: github.com/internal/pkg: reading https://proxy.golang.org/github.com/internal/pkg/@v/list: 403 Forbidden 或 context deadline exceeded。
-
GOPROXY控制“从哪下载”，GOPRIVATE控制“哪些域名不走 proxy”——两者必须配合；只设GOPROXY不设GOPRIVATE，私有库请求仍会被转发给公共代理 - 设置命令：
go env -w GOPROXY=https://goproxy.cn,direct+go env -w GOPRIVATE=git.internal.company/*（通配符支持，路径需匹配 import 路径） - 若私有库需认证，还需配置 git 凭据（如
git config --global url."https://token:x-oauth-basic@github.com/".insteadOf "https://github.com/"） - 验证是否生效：运行
go list -m github.com/internal/pkg，若返回模块信息而非报错，说明已正确解析
go.sum 校验失败后乱改文件？别碰它，先清缓存
典型错误信息：verifying github.com/sirupsen/logrus@v1.9.3: checksum mismatch。
- 绝对不要手动编辑
go.sum—— 它是 Go 工具链自动生成的校验快照，手改会导致后续构建不可控 - 真正原因通常是：模块缓存损坏、网络中间件污染（如公司代理缓存了旧版包）、或上游篡改了已发布 tag（极少见但发生过）
- 标准修复步骤：先运行
go clean -modcache清空本地模块缓存，再执行go mod download重新拉取全部依赖 - 若仍失败，检查是否误设了
GOSUMDB=off（仅调试用，生产环境禁用），或确认go.sum是否被 git 忽略导致协作者缺失该文件
最易被忽略的一点：模块路径一旦写进 go.mod，就决定了整个项目的 import 兼容性边界。改路径 ≠ 改文件夹名，所有下游引用它的代码都得同步改 import 语句——这不是“重命名项目”，而是“发布新模块”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
