根本原因是模块路径与import路径不一致或go.mod中module名与目录结构错位；需确保go mod init在项目根目录执行、module名匹配import前缀、用replace处理本地依赖，并运行go mod tidy验证。
go mod init 之后为什么 go build 报错找不到包
根本原因是模块路径与实际 import 路径不一致，或者 go.mod 中声明的 module 名和项目目录结构错位。常见于从非空目录直接初始化、或把项目放在 $GOPATH/src 下却启用了 Go Modules。
实操建议：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确保
go mod init在项目根目录执行，且该目录不嵌套在$GOPATH/src内（Go 1.16+ 默认关闭 GOPATH 模式，但混用仍会出问题） - module 名必须匹配代码中所有
import的前缀，比如go mod init github.com/yourname/project，那么import "github.com/yourname/project/sub"才能被正确解析 - 如果本地依赖尚未发布，用
replace临时指向本地路径：replace example.com/lib => ./local-lib - 运行
go mod tidy后检查go.sum是否生成、go list -m all是否列出全部依赖
GitHub Actions 里 go setup 失败：no such file or directory: go
这不是 Go 没装上，而是 actions/setup-go@v4 默认只把 go 放进 PATH，没处理 GOROOT 或 GOBIN —— 当 workflow 中显式调用 $GOROOT/bin/go 或依赖 GOBIN 路径时就会失败。
实操建议：
- 删掉所有硬编码的
$GOROOT引用，统一用go命令本身（Actions 的 setup-go 已确保它可用） - 避免在 CI 脚本里写
export GOROOT=...，setup-go 会自动设置好环境变量 - 若需多版本测试，用
with.version指定，不要手动下载二进制：uses: actions/setup-go@v4+with: { version: '1.21' } - 构建前加一步验证：
run: go version && which go，快速定位 PATH 问题
跨平台编译产物体积大，且 Windows 上运行报 missing DLL
默认启用 CGO_ENABLED=1，导致静态链接失效、依赖系统 libc 或 Windows DLL；同时未禁用调试信息，使二进制膨胀 2–3 倍。
实操建议：
- 交叉编译前设环境变量：
CGO_ENABLED=0，强制纯 Go 构建（适用于 net/http、crypto 等标准库，但会禁用 sqlite、openssl 等 cgo 包） - 加编译标志精简体积：
go build -ldflags="-s -w" -o app.exe，其中-s去符号表，-w去调试信息 - 目标平台明确时，显式指定：
GOOS=windows GOARCH=amd64 go build，避免依赖当前 host 环境 - 若必须用 cgo（如调用 C 库），则需在对应平台机器上编译，或用 Docker 构建镜像（如
golang:1.21-alpine）
CI 中 go test -race 总是超时或内存溢出
竞态检测器（race detector）本身开销大，尤其在并发多、循环多、或测试覆盖大量第三方包时，容易触发 GitHub Actions 的 60 分钟超时或 7GB 内存上限。
实操建议：
- 只对关键模块启用：
go test -race ./pkg/core/... ./pkg/http/...，避开 vendor 和工具类目录 - 限制并发数：
go test -race -p 2，防止 goroutine 泛滥拖垮 runner - 跳过已知不安全但可控的第三方依赖：
go test -race -vet=off，避免 vet 阶段重复分析 - 在 CI 中分阶段运行：先跑普通
go test，再单独起 job 跑-race，失败时不阻塞主流程
runtime: out of memory。这些点不提前对齐，敏捷节奏很快就会变成“每天花两小时修环境”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
