最常见解决方案是运行go mod tidy，它自动同步go.mod和go.sum文件，添加缺失依赖校验和并移除无用条目；若失败可尝试清理缓存后重建或手动添加依赖。
go mod tidy 报错 missing go.sum entry
这是最常见但容易被忽略的依赖错误：模块下载成功了，go.mod 也更新了，但 go.sum 缺少对应校验和。Go 工具链会直接拒绝构建或测试。
根本原因是本地缓存或代理（比如 GOPROXY）返回了模块 zip 包，但没同步提供 go.sum 所需的 checksum 行；或者你手动编辑过 go.sum 删除了某行。
- 先运行
go mod download -v看具体哪个模块失败，输出里会带出缺失的 module@version 格式 - 确认 GOPROXY 是否可靠——临时换成官方源试：
GOPROXY=https://proxy.golang.org,direct go mod tidy - 如果确定模块合法且只是校验和丢失，可强制刷新：删掉
go.sum，再执行go mod tidy（注意：仅限开发环境，CI 中慎用）
import 路径能解析但编译报错 undefined: xxx
看起来 import 没问题，go list -m all 也能看到模块，但调用函数/类型时提示未定义——大概率是版本不匹配导致符号缺失。
比如你 import 的是 github.com/sirupsen/logrus，但代码里用了 logrus.WithError()，而当前 go.mod 锁定的是 v1.7.0（该方法在 v1.8.0+ 才引入）。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 查实际加载版本：
go list -m github.com/sirupsen/logrus - 查该版本是否含目标符号：
go doc github.com/sirupsen/logrus@v1.7.0 WithError（若无输出说明不支持） - 升级指定模块：
go get github.com/sirupsen/logrus@latest或显式指定版本如@v1.9.0 - 注意：某些模块大版本升级（如 v2→v3）会改 import 路径，必须同步改代码里的
import行
go build 提示 cannot find module providing package
不是找不到整个模块，而是找不到某个子包（例如 github.com/gin-gonic/gin/binding），常见于模块未发布子路径、或版本 tag 不包含该路径。
本质是 Go 的 module path 和文件系统路径不一致：模块根路径是 github.com/gin-gonic/gin，但 binding/ 目录可能只在某个 commit 存在，而你锁住的 tag 里没有它。
- 检查该子包是否存在：访问
https://github.com/gin-gonic/gin/tree/v1.9.1/binding（把 v1.9.1 换成你go.mod里锁的版本） - 用
go list -f '{{.Dir}}' github.com/gin-gonic/gin/binding@v1.9.1看是否返回路径；空输出即不存在 - 解决方案只有两个：换一个含该子包的版本，或改用其他方式实现（比如不用
gin/binding，自己写 validator）
vendor 目录下有包但 go run 仍报错
启用 vendor 后，go run 默认仍走 module mode，不会自动用 vendor 下的代码——除非显式加 -mod=vendor 参数。
很多人误以为放了 vendor 就万事大吉，结果 CI 构建失败，本地却正常（因为本地 GOPATH 或缓存残留旧版本）。
- 验证是否真走 vendor：
go list -m -f '{{.Dir}}' github.com/pkg/errors，输出应为./vendor/github.com/pkg/errors - 构建时务必带上：
go build -mod=vendor或GOFLAGS=-mod=vendor go test ./... - 注意：
go mod vendor不会拉取 indirect 依赖，如有需要，先执行go mod edit -droprequire清理再重生成
go.sum 或 vendor，先用 go list 和 go doc 把模块实际状态打出来再说。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
