Go环境搭建失败主因是PATH未生效或GOPROXY未配置：go version报错需检查PATH与GOROOT，go run慢或依赖拉取失败须设GOPROXY=https://goproxy.cn,direct，现代Go（1.16+）默认启用Modules，GOPATH已非必需。
Go 环境搭不起来，八成卡在 go version 报错或 go run 找不到命令——不是没装，是 PATH 没生效，或 GOPROXY 没设对。现代 Go（1.16+）默认启用 Modules，GOPATH 已非必需，硬配反而容易冲突。
go version 命令无效？先查 PATH 和 GOROOT
终端输 go version 提示“command not found”，说明系统根本找不到 go 二进制文件。
- Windows：检查安装时是否勾选了「Add Go to PATH」；若手动解压安装，需把
C:\Program Files\Go\bin（或你自定义的%GOROOT%\bin）加进系统环境变量Path - macOS/Linux：运行
which go，若无输出，说明/usr/local/go/bin（或你解压的路径）没写入 shell 配置文件（如~/.zshrc）。补上这行：export PATH=$PATH:/usr/local/go/bin，再执行source ~/.zshrc - 验证
GOROOT是否被意外覆盖：运行go env GOROOT，正常应输出类似/usr/local/go；如果为空或指向错误路径，用go env -w GOROOT=/usr/local/go重置
go run 编译慢、依赖拉不下来？必须设 GOPROXY
国内直连 proxy.golang.org 基本超时，go get 或 go mod tidy 会卡住甚至失败。
- 执行这条命令一次性配置代理（推荐国内镜像）：
go env -w GOPROXY=https://goproxy.cn,direct - 若公司内网有私有代理，可替换为内部地址，末尾保留
,direct表示对私有模块跳过代理 - 验证是否生效：运行
go env GOPROXY，输出应与设置一致；再试go mod download github.com/gin-gonic/gin@v1.9.1，几秒内完成即成功 - 注意：某些旧脚本或 CI 环境会 unset 环境变量，建议在项目根目录加
.env或 CI 配置中显式 export
go build 和 go run 的行为差异必须分清
go run 是临时编译并执行，不生成文件；go build 生成可执行文件但默认不运行——混淆这两者会导致调试反复编译、部署漏打包。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
go run .：编译当前目录下所有.go文件（含main包），适合快速验证逻辑 -
go build -o app ./cmd/main.go：只编译指定入口文件，输出名为app的可执行文件，适合构建发布包 - 常见坑：
go build main.go在非模块根目录下会报cannot find module for path，因为 Go 默认按模块路径解析 import；解决方法是确保在模块根目录执行，或加-mod=mod参数 - 跨平台编译记得设
GOOS和GOARCH，比如GOOS=linux GOARCH=arm64 go build -o myapp
go mod init 初始化失败？检查当前目录和 go.mod 冲突
新建项目跑 go mod init example.com/myapp 却提示 “already in module” 或 “not in a git repo”，通常是残留文件或路径问题。
- 先删掉当前目录下的
go.mod、go.sum和vendor/（如有），再重新 init - 避免在
$GOPATH/src下初始化模块——Go Modules 模式下，项目位置任意，但不能嵌套在另一个模块内 - 模块名不必是真实域名，只是命名空间；本地开发可用
myapp，但上线前建议改成有意义的路径，否则import语句会出问题 - 如果目录含中文或空格，某些工具链会异常；尽量用纯英文路径
真正麻烦的不是装 Go，而是不同环境（本地、CI、容器）之间 GOENV、GOPROXY、GO111MODULE 这几个开关状态不一致。每次换机器或重装系统，优先跑一遍 go env -w 设置，比反复排查快得多。
