Go 命令无内置环境搭建向导，需手动配置 GOPROXY、GO111MODULE 等环境变量，并通过 go mod init 初始化模块；仅 go run 成功不代表环境完备，须验证代理、模块模式及子工具（如 gopls）是否正常。
go 命令本身没有“环境搭建向导”这个交互式工具。所谓“向导”，其实是新手误读了安装包行为或 IDE 提示——Windows 上的 .msi 安装包会自动配置 PATH，VS Code / GoLand 启动时可能弹出初始化提示，但这些都不是 Go 自带的向导。
真正需要你手动干预的关键步骤，就藏在几个命令和环境变量里。
go version 和 go env 是你的第一道验证关卡
打开 CMD 或 PowerShell，直接运行：go version —— 必须有输出，形如 go version go1.25.0 windows/amd64go env —— 检查 GOROOT（应指向安装路径，如 C:\Program Files\Go）和 GOPATH（默认是 %USERPROFILE%\go，可不改）
GOPROXY 必须手动设，否则拉包必卡
国内不配代理，go get 或 go mod download 会超时失败，错误信息通常是：proxy.golang.org: dial tcp 216.239.37.1:443: i/o timeout
立即学习“go语言免费学习笔记（深入）”；
执行以下三条命令（永久生效）：go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.google.cn
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
验证是否生效：go env GOPROXY 应输出 https://goproxy.cn,direct
go mod init 是现代 Go 项目的起点，不是可选项
不要把代码扔进 GOPATH\src 下再运行 go build —— 这种方式已过时且容易引发包导入混乱。
正确做法：
- 新建任意目录，比如 D:\myapp
- 进入该目录，运行：go mod init myapp
- 此时生成 go.mod 文件，后续所有依赖管理、版本锁定都基于此
如果项目名含域名（如 github.com/you/repo），建议直接用完整路径：go mod init github.com/you/repo，避免后期重命名或迁移麻烦
go run hello.go 不报错 ≠ 环境完全可用
常见假成功场景：
- 能跑 hello.go，但 go get github.com/gorilla/mux 失败 → 代理没生效
- go env GOPATH 输出空 → GOPATH 被误删，某些老工具（如 gopls 旧版）可能异常
- go build 出 cannot find module providing package ... → 当前目录没 go.mod，或 GO111MODULE 被设为 auto 且不在 GOPATH 内
最简真验证组合：go mod init testecho "package main; import \"fmt\"; func main(){fmt.Println(\"ok\")}" > main.gogo run main.go && go build -o test.exe main.go
复杂点在于：Go 工具链本身不报错，但 IDE 插件、linter、debugger 依赖的子工具（如 gopls、dlv）可能因代理或模块模式未启用而静默失效。别只盯着 go run 成功就认为万事大吉。
