go version报错说明path未包含go的bin目录，需关闭所有终端后手动将c:\program files\go\bin等路径加入系统path并重启命令行验证。
go version 命令报错或找不到
说明 go 命令根本没进系统 PATH，不是安装失败，而是环境变量没生效。Windows 上用 .msi 安装包时，它会自动写入 PATH，但**必须关闭所有已打开的 CMD/PowerShell 窗口再重新打开**，否则旧会话看不到新变量。
- 检查是否真没配：在新打开的终端里执行
echo %PATH%（CMD）或$env:PATH（PowerShell），看输出里有没有C:\Program Files\Go\bin或你自定义的安装路径下的\bin - 如果没出现，手动加：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里找到
Path，点“编辑”→“新建”，填入你的 Go 安装目录下的bin路径（例如D:\software\Go\bin） - 别手误写成
GOROOT目录本身——必须是GOROOT\bin
go mod init 后 go get 报 timeout 或 denied
这是国内网络下最典型的现象，本质是模块代理没开或配置错。Go 1.16+ 默认启用 modules，但默认代理 proxy.golang.org 在国内基本不可用。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须执行这三条命令（CMD 中运行）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
GOPROXY值里的direct很关键：当goproxy.cn没有某个包时，会 fallback 到官方源，避免因镜像滞后导致拉不到私有或新发布包 - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct；如果还是空或https://proxy.golang.org，说明上一步没成功 - 某些企业网络会拦截
sum.golang.org，此时可临时设为go env -w GOSUMDB=off（仅调试用，上线前应恢复）
go build 编译失败，提示 missing $GOROOT/src/runtime
这不是代码问题，而是 GOROOT 被错误覆盖或指向了空目录。现代 Go 安装（尤其是 .msi）会自动设好 GOROOT，**绝大多数情况你完全不需要手动设置它**。
- 先查当前值：
go env GOROOT—— 正常应输出类似C:\Program Files\Go的路径 - 如果输出为空、乱码，或指向一个不存在的路径（比如
D:\go但该目录下没有src文件夹），就说明被人为改坏了 - 修复方式：直接删掉系统环境变量里的
GOROOT（不是PATH！），重启终端，go会自动定位到真实安装位置 - 只有当你装了多个 Go 版本并需要切换时，才需手动设
GOROOT；日常开发中设了反而容易出问题
依赖编译后二进制体积异常大
Go 默认静态链接，go build 出来的文件包含运行时和所有依赖代码，几十 MB 很常见。这不是 bug，但可以优化。
- 加
-ldflags="-s -w"：去掉符号表和调试信息，通常能减小 30%–50% 体积go build -ldflags="-s -w" -o app.exe main.go - 加
-trimpath：移除编译路径信息，进一步压缩且提升可重现性go build -trimpath -ldflags="-s -w" -o app.exe main.go - 注意：这些参数不影响功能，但会丢失 panic 时的文件名和行号——调试阶段可先不用，发布前加上
- 若仍过大，检查是否无意引入了
net/http/pprof、GUI 库或大型图像处理库，它们自带大量依赖
GOROOT 结果把它搞挂了。每一步做完，都用对应命令当场验证，比事后排查快十倍。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
