go 1.16+ 默认启用模块（go111module=on），无需手动配置 gopath 即可开发，但 goroot 和 path 必须正确；验证需用 which go 或 where go 确认路径，go env goroot 和 go env go111module 应分别输出正确安装路径和 on。
Go 1.16+ 默认启用模块（GO111MODULE=on），无需手动配置 GOPATH 即可正常开发；但 GOROOT 和 PATH 必须正确，否则 go 命令根本无法识别。
验证 go 命令是否真正可用
很多初学者看到 go version 有输出就以为环境 OK，其实只是 PATH 里碰巧有旧版本或别名。真实问题常出现在：go run 报错 “command not found”，或 go mod init 提示 “unknown command”。
- 在干净终端（如新开 PowerShell 或 zsh）中执行
which go（macOS/Linux）或where go（Windows），确认路径指向你安装的 Go 目录（如/usr/local/go/bin/go或C:\Go\bin\go.exe） - 运行
go env GOROOT，输出应与你安装路径一致；若为空或错误，说明GOROOT未生效 - 执行
go env GO111MODULE，预期输出必须是on；若为auto或空，可能在 GOPATH 下触发旧模式，导致go.mod被忽略
go build 编译失败的三个高频原因
不是代码写错了，而是构建上下文没对。常见现象：本地能 go run，但 go build 出错，或生成的二进制在其他机器上直接崩溃。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
CGO_ENABLED=0没关：默认开启 CGO，会链接系统 libc；跨平台编译或 Alpine 镜像中运行时大概率报no such file or directory。编译前加CGO_ENABLED=0 go build -o myapp . - 没指定
-ldflags去除调试信息：默认生成的二进制含 DWARF 符号，体积大且暴露路径。建议加-ldflags="-s -w"（-s去符号表，-w去调试信息） - 模块路径不匹配：
go mod init时用了非法路径（如含大写字母、下划线），后续import语句和实际目录结构对不上，go build会静默跳过某些文件
跨平台编译必须设对 GOOS 和 GOARCH
Go 原生支持交叉编译，但不是所有组合都默认可用——尤其 Windows 上编译 Linux 二进制，或 macOS 上编译 Windows，容易因工具链缺失失败。
- 先查当前支持目标：
go tool dist list，输出类似darwin/amd64 darwin/arm64 linux/386 linux/amd64 windows/386 windows/amd64 - 编译 Windows 可执行文件（从 macOS/Linux）：
GOOS=windows GOARCH=amd64 go build -o app.exe .；注意扩展名需手动加.exe - ARM64 设备（如 M1/M2 Mac、树莓派）上编译 ARM64 二进制时，别漏掉
GOARCH=arm64；只设GOOS不够，GOARCH默认仍是amd64 - 若提示
cannot find package "C"，说明 CGO 被触发但目标平台无 C 工具链——此时必须加CGO_ENABLED=0
VS Code 中调试器不中断、断点灰掉
不是插件没装，而是 dlv（Delve）调试器版本与 Go 版本不兼容，或启动配置没绕过模块缓存。
- 用
go install github.com/go-delve/delve/cmd/dlv@latest安装最新版dlv，别用 brew/apt 安装的旧包 - 确保
.vscode/launch.json中"mode": "exec"对应已编译二进制，"mode": "test"才跑测试；混用会导致断点无效 - 调试前删掉
./.vscode和$HOME/.dlv缓存目录，避免旧配置干扰 - 如果项目在 symlink 目录下，Delve 可能解析不到源码路径——把项目移到真实路径再试
最易被忽略的是：go mod tidy 后没检查 go.sum 是否更新完整，导致 CI 构建时拉不到依赖；以及跨平台编译后忘了 file app 或 file app.exe 确认目标架构是否真匹配。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
