Go环境搭建完成但开发未就绪，主因是GOPROXY未设为https://goproxy.cn,direct、gopls/dlv未手动安装、GOBIN未加入PATH、项目不在含go.mod的根目录下，需逐项验证并修复。
Go 语言环境搭建完成 go version 能正常输出，不等于开发环境就 ready 了——多数人卡在后续依赖下载失败、工具链缺失、VSCode 提示“gopls not found”这类问题上。
go env 验证时 GOPROXY 显示为空或 proxy.golang.org
这是国内用户最常遇到的阻塞点：模块下载超时、go mod tidy 卡住、go get 报 timeout 或 no such host。
- 不要依赖安装程序自动配置代理，必须手动设置
- 推荐执行：
go env -w GOPROXY=https://goproxy.cn,direct - 若企业内网需跳过私有域名（如
git.corp.com），追加：go env -w GOPRIVATE=git.corp.com - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct，不是https://proxy.golang.org - 注意：Windows PowerShell 中
go env -w可能因权限或策略失效，建议改用 CMD 或在管理员模式下运行
VSCode 提示 “Tool gopls is not available” 或无法跳转定义
这不是插件没装好，而是 Go 工具链没装全。官方 Go 扩展会尝试自动下载 gopls、dlv、goimports 等二进制，但默认源被墙后全部失败。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认
GOBIN是否已加入PATH：go env GOBIN，若为空，执行go env -w GOBIN=$HOME/go/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 手动安装核心工具：
go install golang.org/x/tools/gopls@latest - 再装调试器：
go install github.com/go-delve/delve/cmd/dlv@latest - 重启 VSCode，打开任意
.go文件，状态栏右下角应显示 “gopls (running)” - 如果仍报错，检查
$HOME/go/bin（或对应路径）下是否存在gopls可执行文件，不存在说明GOBIN没生效
go run 正常但 go build 报 “cannot find module providing package”
这通常发生在项目目录外执行构建，或误用了旧式 GOPATH 工作流。
立即学习“go语言免费学习笔记（深入）”；
- 确保当前目录下存在
go.mod文件；没有就运行go mod init example.com/myapp（模块名可任意，不需真实存在） - 不要把项目放在
$GOPATH/src下再用go build—— Go Modules 模式下该路径已废弃，反而会触发兼容性降级 - 检查
go env GOMOD，输出应为当前目录下的go.mod绝对路径；若为空，说明未进入模块根目录 - Windows 用户特别注意：CMD 中路径含空格或中文时，
go mod命令可能静默失败，建议用 PowerShell 或 WSL2
真正容易被忽略的是 GO111MODULE 的隐式状态——它不再需要手动设为 on，但如果你在 $GOPATH/src 目录下初始化项目，Go 仍可能 fallback 到 GOPATH 模式，导致依赖行为不一致。最稳妥的做法：所有新项目都从空白目录开始，go mod init 第一时间执行，其余交给 go mod tidy 自动处理。
