go mod init 必须在项目根目录执行，否则 go build 会因工作目录不在模块作用域内而报“cannot find module providing package”；需先 cd 至含 main.go 的目录再运行 go mod init myapp，并确保 go111module=on、goproxy 正确配置。
go mod init 必须在项目根目录执行，否则 go build 找不到依赖
很多新手在任意子目录下运行 go mod init，结果 go build 报错 cannot load xxx: cannot find module providing package xxx。根本原因是 Go Modules 依赖当前工作目录是否在模块根下——只有 go.mod 所在目录及其子目录才被识别为该模块作用域。
- 正确做法：先
cd到你打算放main.go的空目录，再执行go mod init myapp -
myapp可以是任意合法包名，但建议与项目路径或最终可执行名一致（如github.com/you/project），避免后续导入混乱 - 如果已有代码但没
go.mod，不要在 src/ 或 cmd/ 子目录里 init，必须回到最外层项目目录
第三方模块拉取失败时，GOPROXY 和 GO111MODULE 必须同时生效
国内常见错误是只设 GOPROXY 却没确认模块模式已启用，导致 go get 仍尝试走 GOPATH 路径，报错 go: finding module for package ... 或 could not create module cache: mkdir ... Access is denied。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认为auto，但某些旧 shell 环境可能未生效） - 设置代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示对私有仓库直连） - 验证：执行
go env GO111MODULE GOPROXY，输出应为on和https://goproxy.cn,direct - 注意：Windows 下若用 PowerShell，
go env -w写入的是用户级环境变量，无需管理员权限；但 CMD 有时需重启终端才生效
go install 安装工具后，$GOPATH/bin 必须在 PATH 中才能全局调用
装完 dlv、gofumpt 后执行命令提示 command not found，90% 是因为 $(go env GOPATH)/bin 没加进系统 PATH。
- 先查路径：
go env GOPATH（比如输出/home/user/go，那工具就在/home/user/go/bin） - Linux/macOS：在
~/.zshrc或~/.bashrc加一行export PATH=$PATH:$(go env GOPATH)/bin，然后source ~/.zshrc - Windows：在「系统属性 → 高级 → 环境变量」中，编辑用户变量
Path，新增一项指向%GOPATH%\bin（注意不是%GOROOT%\bin） - VS Code 中若仍报错，检查右下角 Go 状态栏是否显示「gopls not found」——说明编辑器没读到更新后的 PATH，重启 VS Code 或重载窗口
联合编译多个 main 包时，go build 必须指定具体入口文件
项目含多个 cmd/xxx/main.go，直接 go build 会报错 no Go files in current directory 或构建出错包名冲突，因为 Go 不允许模糊构建。
- 正确方式：进入对应
cmd/xxx目录，运行go build -o xxx（生成名为xxx的可执行文件） - 或从项目根目录执行：
go build -o ./bin/xxx ./cmd/xxx，这样能统一输出到bin/目录 - 如果想一次编译全部
main包，用go build ./cmd/...（三个点表示递归匹配所有子目录下的包），但要求每个子目录下只能有一个main.go - 注意：
go run只支持单个main文件，go run ./cmd/xxx是安全的；但go run ./cmd/...会失败
go mod init 的位置和 go env -w 的生效范围，最容易在不同终端或 IDE 中表现不一致。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
