根本原因是go build不自动下载未声明的依赖，需执行go mod tidy扫描import并补全go.mod；若import私有域名还需配置goprivate，且必须在含go.mod的模块根目录执行。
go mod init 之后为什么 go build 还报找不到包？
因为 go build 默认不自动下载未声明的依赖，即使你 import 了第三方包，只要没执行过 go mod tidy 或 go get，go.mod 就不会记录它，构建时自然失败。
常见错误现象：build command-line-arguments: cannot find module for path github.com/sirupsen/logrus
- 执行
go mod tidy是最稳妥的做法：它会扫描所有.go文件里的 import，补全缺失依赖、清理未使用项，并更新go.sum - 如果只想拉某个包，用
go get github.com/sirupsen/logrus@v1.9.3（带版本更安全） - 别手动改
go.mod—— 它是自动生成的，手写容易格式错或漏 checksum - 确保当前目录下有
go.mod；否则go build会退化为 GOPATH 模式，可能误读系统级缓存
GOROOT 和 GOPATH 现在还必须手动设吗？
GOROOT 通常不用动：安装包（如 go1.21.6.darwin-arm64.pkg）会自动注册，go env GOROOT 能验证。GOPATH 在 Go 1.16+ 已非必需，但仍有实际影响：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 如果你用
go install安装命令行工具（比如golangci-lint），它默认输出到$GOPATH/bin，所以$GOPATH/bin必须在PATH里才能直接运行 - 不设 GOPATH 时，Go 会 fallback 到
$HOME/go，但显式设一个（如export GOPATH=$HOME/go）能避免不同 shell 下行为不一致 - 现代项目基本不用
src/pkg/bin结构了，go mod管理依赖后，src只存本项目代码，pkg和bin几乎闲置
国内网络下 go build 卡在 proxy.golang.org 怎么办？
这不是配置问题，是 Go 工具链默认代理不可达导致的阻塞。必须显式设置国内镜像代理，且顺序不能错：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后是direct，不是https://proxy.golang.org） -
direct的作用是：对私有域名（如公司内网模块）跳过代理，直连；没有它，所有非公开模块都会失败 - 顺带加一句
go env -w GONOPROXY=git.internal.company.com，把内部 Git 域名加进豁免列表 - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct；再试go mod download，看是否秒完成
交叉编译时 go build 输出文件为什么在本地跑不了？
因为 go build 默认按当前机器环境编译（比如你在 macOS M1 上跑，就生成 darwin/arm64 二进制）。要生成其他平台可执行文件，必须显式指定目标：
- 编译 Linux 二进制：
GOOS=linux GOARCH=amd64 go build -o myapp-linux . - 编译 Windows：
GOOS=windows GOARCH=amd64 go build -o myapp.exe . - 注意：不支持跨架构动态链接（比如 macOS 上编译
darwin/arm64后想在darwin/amd64运行），必须匹配目标 CPU 架构 - 如果项目用了 cgo，交叉编译会失败——此时需配对应平台的 C 工具链，普通 Go 项目建议关掉：
CGO_ENABLED=0 GOOS=linux go build -a -o myapp .
go build 命令背后，GOROOT 决定用哪个 Go 编译器，GOPROXY 控制依赖怎么拉，GOOS/GOARCH 指定产出形态，而 go.mod 是唯一可信的依赖快照源——任何绕过它的“手动复制 vendor”或“删掉 go.sum”操作，都会让协同编译变得不可靠。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
