Go环境验证需依次检查：1. go version输出正确版本；2. PATH含Go的bin目录且无多版本冲突；3. GOROOT指向安装根目录、GOENV可写；4. 编译运行main.go输出"hello, go"；5. go mod init与go mod tidy成功拉取依赖。
Go 环境能跑 go version，不代表模块能编译；很多“装好了却 go build 失败”的问题，根源不在安装，而在模块初始化和路径干扰。
go command not found 的真实原因和快速验证法
不是没装，是 shell 没认到 go。Windows 上常见于 PowerShell 没重启、PATH 被用户变量覆盖；macOS/Linux 则多因 shell 配置文件（~/.zshrc 或 ~/.bash_profile）没重载或写错路径。
- Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」查C:\Program Files\Go\bin是否在 PATH 里，改完必须新开终端 - macOS/Linux：运行
which go，无输出就检查export PATH=$PATH:/usr/local/go/bin是否写进对应 shell 配置，并执行source ~/.zshrc - 别信安装器勾选的“添加到 PATH”——它只写注册表或 plist，不自动生效
go mod init 失败的三个隐藏条件
go mod init 不是“有目录就能跑”，它会主动避开旧式 GOPATH 约束，但也会被残留结构反向劫持。
- 当前目录不能在
$GOPATH/src下——否则会按旧路径推导 module 名，比如生成module github.com/xxx/yyy而非你想要的module myapp - 项目根目录下不能有
vendor/目录——存在时go mod init可能静默跳过或报错cannot initialize new module in existing module root -
GO111MODULE必须为on：运行go env -w GO111MODULE=on，尤其 CI 或老脚本可能仍设为off
独立模块编译时 go build 的关键参数组合
go build 默认生成同名二进制，但实际开发中常需控制输出名、目标平台、构建标签，且容易忽略工作目录影响。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 必须在含
go.mod的目录下执行，否则报go: go.mod file not found -
go build -o ./bin/app：指定输出路径，避免污染源码目录；./bin/需提前创建 -
go build -ldflags="-s -w"：减小二进制体积（剥离调试信息和符号表），上线前建议加 - 跨平台编译需设环境变量：
GOOS=linux GOARCH=amd64 go build -o app-linux，注意 Windows 上要用 PowerShell 语法$env:GOOS="linux"
VS Code 中 gopls 启动失败不是插件问题
gopls 是语言服务器，依赖 go 命令本身可用 + 项目有 go.mod + 文件后缀为 .go。三者缺一，它就卡在“正在启动”或直接退出。
- 打开 VS Code 终端，手动运行
go version和go list -m（应在模块根目录），任一失败则gopls必挂 - 确认文件保存为
main.go（不是main.txt或未保存），且包声明为package main - 如果项目用了 vendor，需关掉：删掉
vendor/并确保go env GOPROXY不为direct（否则依赖解析失败）
最常被跳过的动作是：删 vendor/、切出 $GOPATH/src、再 go mod init ——这三步做完，90% 的模块编译问题就消失了。
