必须满足go版本≥1.16、go111module=on、项目根目录存在go.mod三前提，缺一导致编译失败；需检查工作目录、模块开关状态，必要时执行go mod init和go mod tidy，并配置goproxy与gosumdb。
直接用 go 命令就能编译开源项目的 Go 代码，但必须满足三个前提：Go 版本 ≥1.16、GO111MODULE=on、项目根目录下有 go.mod。缺一不可，否则会报 no go files in current directory 或 cannot find module providing package。
为什么 clone 下来的开源项目编译失败？
常见现象是执行 go build 或 go run . 报错，提示找不到包或模块路径错误。根本原因不是代码写错了，而是当前工作目录没识别为 Go Module 项目。
- 检查是否在项目根目录（含
go.mod文件的目录）下操作； - 运行
go env GO111MODULE，输出必须是on，不是auto或空； - 若项目使用旧版 GOPATH 模式（无
go.mod），需先手动初始化：go mod init github.com/owner/repo，再补全依赖：go mod tidy； - 某些仓库（如
golang/go）本身不走 module 模式，要进src目录用./make.bash（Linux/macOS）或make.bat（Windows）编译，不能用go build。
国内拉取依赖总超时？代理配置必须生效
GOPROXY 配置错或未生效，会导致 go mod tidy 卡住、报 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 永久设置（推荐）：
go env -w GOPROXY=https://goproxy.cn,direct； - 验证是否写入：
go env GOPROXY应输出完整字符串，不是空或https://proxy.golang.org； - 如果项目用了私有模块（如公司内网 Git），需额外加
go env -w GOPRIVATE=git.internal.company.com，否则代理会跳过它并直连失败； - 临时绕过代理只试一次：
GOPROXY=direct go mod tidy，可用于确认是不是代理问题。
贡献代码前，如何本地验证编译和测试？
提交 PR 前必须确保代码能通过项目原有构建流程，光跑通 go run 不够，得模拟 CI 环境。
- 先看项目根目录是否有
.github/workflows或Makefile，优先照着跑：make test或go test -v ./...； - 注意
go test默认不运行带// +build ignore标签的文件，而某些项目用这个控制集成测试开关； - 交叉编译验证（如项目支持多平台）：
GOOS=linux GOARCH=arm64 go build -o mybin，避免硬编码路径或系统调用导致的兼容问题； - 格式必须统一：运行
gofmt -w .或go fmt ./...，很多项目 CI 会检查git diff是否为空，否则拒绝合并。
最易被忽略的是模块校验开关 GOSUMDB。如果设成 off，go mod download 会跳过 checksum 验证，本地能过，CI 却因校验失败中断——正确做法是保持 GOSUMDB=sum.golang.org 或换国内镜像 GOSUMDB=gosum.io+ce6e7565+AY5qEHUk/qmHc5btzW45JVoENsOQKf80Lx2F8yZu9tU=。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
