Go 1.16+ 默认启用 GO111MODULE=on，GOPATH 仅用于安装二进制（如 $GOPATH/bin），不再存放项目源码；项目必须有 go.mod 且含 main.go 才能正常构建，否则报 “no Go files” 或依赖错误。
Go 环境现在默认启用 GO111MODULE=on，GOPATH 已退居次要地位；依赖管理完全由 go mod 控制，手动配置 GOPATH/src 放项目已过时，强行沿用反而导致 go build 失败或依赖拉取混乱。
go build 为什么找不到 main 包或报错 “no Go files in current directory”
常见于刚建目录就直接执行 go build，但没初始化模块或没写 main.go。
- 必须存在至少一个
.go文件，且该文件里有package main和func main() - 若当前目录无
go.mod，go build会尝试按 GOPATH 模式查找，但 Go 1.16+ 默认拒绝在非模块路径下构建（除非显式加-mod=mod或降级） - 解决方法：先运行
go mod init example.com/myapp初始化模块，再确保main.go在当前目录 - 错误示例：
go build在空目录或只有lib/utils.go（非 main 包）的目录下执行 → 直接失败
go get 失败、超时或提示 “unknown revision” 怎么办
本质是模块代理或校验机制拦截了请求，不是网络不通，而是策略不匹配。
- 国内用户必须设
GOPROXY，推荐值：https://goproxy.cn,direct或https://proxy.golang.org,direct（后者需能访问境外） - 同时要关掉校验和数据库强制校验：
GOSUMDB=off（仅开发阶段）或设为sum.golang.org（生产环境需配代理） -
go get github.com/gin-gonic/gin@v1.9.1报 “unknown revision”：说明该 tag 不存在，或远程仓库已删 tag；改用@latest或查 GitHub Release 页面确认真实版本号 - 避免用
go get安装命令行工具（如gopls），应改用go install+ 版本后缀：go install golang.org/x/tools/gopls@latest
go mod tidy 下载的依赖为什么没进 vendor？
go mod vendor 不是自动触发的，它只是快照当前 go.sum 和 require 到本地 vendor/ 目录，且默认不启用 vendor 模式。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 执行
go mod vendor后，还需加-mod=vendor参数才能让后续命令（如go build）真正从vendor/读依赖 - 验证是否生效：
go build -mod=vendor→ 成功；go build（无参数）→ 仍走网络代理 - 注意：
vendor/不解决私有模块问题，私有 repo 需额外配replace或GOPRIVATE环境变量 - CI/CD 中慎用 vendor：它增大体积、易 stale，现代 Go 推荐直接依赖 proxy + clean cache
交叉编译 Linux 可执行文件却在 Windows 上运行失败
Go 的跨平台编译靠的是目标 OS/arch 的标准库预编译，不是模拟器 —— 编译结果只能在目标系统跑。
- 在 Windows 上编译 Linux 二进制：
GOOS=linux GOARCH=amd64 go build -o app-linux - 生成的
app-linux是纯 Linux ELF 文件，Windows 默认无法执行（哪怕装了 WSL 也得进 WSL 环境里跑） - 检查文件类型：
file app-linux应输出ELF 64-bit LSB executable, x86-64；若显示PE32+，说明没设GOOS，还是 Windows 版本 - ARM 服务部署常见坑：
GOARCH=arm64编译后扔到树莓派（aarch64）能跑，但扔到旧 ARMv7 设备会段错误 —— 必须用GOARM=7+GOARCH=arm
模块路径、replace 语句、GOPROXY 三者优先级容易混淆；实际构建时，go build 读的是 go.mod 解析后的最终依赖图，不是你本地文件结构 —— 这点在调试私有包或 fork 替换时最易出错。
