必须验证go version和go env，强制设置go111module=on、goproxy=https://goproxy.cn,direct，私有库需配置goprivate；vs code须通过终端启动以继承环境变量，gopls依赖正确模块路径与go.mod。
Go 开发环境配置本身不依赖命令行工具，但实际落地时，go、cobra-cli、gopls 等命令行工具直接决定配置是否生效、能否调试、是否能自动补全——绕不开它们。
go version 和 go env 必须第一时间验证
很多问题其实源于安装假成功：.pkg/.msi 安装了，但 PATH 没生效，或系统残留旧版本。务必在全新终端中运行：
-
go version—— 输出必须含明确版本号（如go1.26.0），不能是command not found或go version devel -
go env GOPATH—— 即使启用 Go Modules，也要确认该值合理（macOS/Linux 通常为~/go，Windows 为C:\Users\{user}\go） -
go env GOROOT—— 应指向 Go 安装根目录（如/usr/local/go），而非$GOPATH下的子路径
GO111MODULE 和 GOPROXY 不设就卡死在依赖拉取
国内网络下，不配代理，go mod download 或 go get 基本必超时或 403。这不是可选项，是启动任何模块化项目的前提：
- 强制开启模块：
go env -w GO111MODULE=on - 设国内代理（推荐清华或 goproxy.cn）：
go env -w GOPROXY=https://goproxy.cn,direct - 私有仓库必须加
GOPRIVATE：go env -w GOPRIVATE=git.internal.company.com/* - 验证是否生效：
go env GOPROXY GOPRIVATE，输出应非空且不含proxy.golang.org
cobra-cli init 后要手动检查 cmd/root.go 的 Execute 调用
用 cobra-cli init mytool 生成骨架后，main.go 默认只调用 rootCmd.Execute()，但实际项目常需捕获错误并退出非零码：
- 原始写法易静默失败：
rootCmd.Execute() - 应改为显式错误处理：
if err := rootCmd.Execute(); err != nil { os.Exit(1) } - 否则当参数解析失败、子命令未注册或
Run中 panic 时，程序可能直接退出 0，掩盖真实问题 - 另注意：若项目不在
$GOPATH/src下，cobra-cli生成的import路径可能错，需手动修正为实际 module 名
VS Code 中 gopls 启动失败多数因 GOPATH 或代理配置未同步
VS Code 的 Go 插件依赖 gopls 提供语言服务，但它不读 VS Code settings.json 里的 go.toolsEnvVars，而是读 shell 环境变量。常见症状：无代码补全、跳转失效、保存不格式化。
- 确保终端启动 VS Code：
code .（而非桌面图标双击），这样它能继承 shell 的GOPROXY、GOPATH等 - 检查
gopls是否已安装：which gopls；未安装则运行go install golang.org/x/tools/gopls@latest - 若仍报
no modules found，大概率是当前工作区路径没在 module 根目录下，或go.mod缺失 - 重启 VS Code 后，在命令面板（Cmd+Shift+P）执行 “Go: Restart Language Server” 观察输出日志
真正卡住人的从来不是某一步操作，而是多个环境变量、工具链版本、IDE 启动方式之间隐性耦合——比如你在 zshrc 里配了 GOPROXY，却用 Finder 双击打开 VS Code，它根本看不到那个变量。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
