Go环境真正搭好需满足四点：能运行go version输出版本号、go env GOPATH返回有效路径、GO111MODULE=on、GOPROXY设为https://goproxy.cn,direct；缺一可能导致go mod download卡死或报错。
Go 环境能跑 go version 并输出版本号，才算真正搭好；光装了二进制但没配对环境变量、没设 GO111MODULE=on、没配代理，后续 go mod download 会卡死或报错。
验证 go 命令是否真可用
别只看安装程序有没有“完成”提示。Windows 用户常被 MSI 安装器误导——它默认只把 go 加进系统 PATH，但不设 GOPATH 和 GO111MODULE；macOS/Linux 用 tar -xzf 解压后，PATH 没 reload 就查不到命令。
- 打开新终端（不是旧窗口），执行
go version，必须看到类似go version go1.22.0 linux/amd64的输出 - 再执行
go env GOPATH，应返回一个有效路径（如/home/you/go或$HOME/go），不是空或unknown - 执行
go env GO111MODULE，必须是on，不是auto或空 —— 否则新建项目时go mod init不生效
国内用户必须配 GOPROXY
不配代理，go get 或 go mod download 会连不上 golang.org/x/... 等官方子模块，报错像 Get "https://proxy.golang.org/...": dial tcp: i/o timeout 或直接卡住十分钟没反应。
- 推荐配置：
go env -w GOPROXY=https://goproxy.cn,direct - 如果公司内网有私有代理，可换成
https://your-proxy.example.com，末尾仍保留,direct作 fallback - 验证是否生效：运行
go env GOPROXY，输出应与设置一致；再试go mod download golang.org/x/net，几秒内完成即成功
VS Code 装 Go 插件后要手动装工具链
VS Code 的 Go 扩展（由 Go Team at Google 发布）只是个壳，真正干活的 gopls（语言服务器）、dlv（调试器）、staticcheck 都得单独下载。插件弹窗点 “Install All” 失败很常见，尤其网络不稳定时。
立即学习“go语言免费学习笔记（深入）”；
- 手动安装命令（在终端中运行）：
go install golang.org/x/tools/gopls@latest、go install github.com/go-delve/delve/cmd/dlv@latest - 装完检查：
which gopls和which dlv应返回路径，比如/home/you/go/bin/gopls - VS Code 设置里确认
"go.goplsPath"指向正确位置，否则编辑器里没语法提示、跳转失效
初始化项目别漏掉 go mod init
新建文件夹写完 main.go，直接 go run main.go 是能跑，但一旦引入第三方包（比如 github.com/spf13/cobra），就会报 no required module provides package —— 因为没启用模块模式。
- 务必在项目根目录下执行：
go mod init example.com/myapp（域名部分可任意，只要合法） - 执行后生成
go.mod文件，里面会有module example.com/myapp和go 1.22行 - 后续所有
go get会自动写入go.mod和go.sum，这是 Go 1.11+ 的标准依赖管理方式，别手建vendor/
最容易被忽略的是 GO111MODULE=on 和 GOPROXY 这两个环境变量，它们不显眼，但缺一不可；很多“环境已装好”的假象，都止步于第一次 go mod download 失败。
