技术调研需验证三个可执行动作：go version能运行、go mod init能拉包、go run main.go能输出结果；其余配置如GOPATH在Go 1.16+模块模式下已非必需。
直接看结论：技术调研不是查文档清单，而是验证三个可执行动作——go version能跑、go mod init能拉包、go run main.go能输出结果。其余配置项（比如GOPATH）在 Go 1.16+ 默认开启 module 模式后已非必需，强行深挖反而容易踩坑。
验证 go 命令是否真正可用
很多人卡在“明明装了 Go，但终端报 'go' 不是内部或外部命令”。这不是安装失败，是 PATH 没生效。
- Windows 下检查
Path系统变量里是否包含C:\Go\bin（默认路径）或你自定义的安装路径下的\bin目录 - macOS/Linux 下运行
echo $PATH，确认输出里有类似/usr/local/go/bin或$HOME/sdk/go/bin这样的路径 - 别信“安装程序自动配好了”——重启终端或执行
source ~/.zshrc（macOS）/refreshenv（PowerShell）后再试
确认模块代理是否生效
国内环境下，go mod download 卡住或报 timeout、no matching versions，基本都是 GOPROXY 没设对。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 执行
go env GOPROXY，正确输出应为类似https://goproxy.cn,direct（注意逗号分隔，direct表示私有模块直连） - 如果显示空或
https://proxy.golang.org,direct，立刻执行：go env -w GOPROXY=https://goproxy.cn,direct - 验证方式：新建空目录，运行
go mod init example.com/test && go get github.com/google/uuid，5 秒内完成即正常
区分 GOPATH 和 Go Modules 的实际影响
很多教程还在讲 GOPATH/src 目录结构，这在 module 模式下已成历史包袱。
立即学习“go语言免费学习笔记（深入）”；
-
GOPATH现在只影响go install生成的二进制存放位置（$GOPATH/bin），不影响项目构建 - 只要项目根目录有
go.mod文件，go build就完全无视GOPATH，依赖全部从vendor或代理下载 - 新手唯一需要关心的，是确保
GO111MODULE是on（Go 1.16+ 默认开启，用go env GO111MODULE确认）
真正容易被忽略的点是：环境变量修改后，IDE（VS Code / GoLand）不会自动重载 shell 配置。关掉所有编辑器窗口，再重新打开项目，否则 gopls 仍可能报找不到依赖或无法跳转定义。
