go依赖下载失败多因网络或代理配置问题，需正确设置goproxy和goprivate并排查连通性；国内用户应将goproxy设为清华源或goproxy.cn，私有库须通过goprivate排除，调试可用goproxy=direct或-v参数定位问题。
Go 环境能跑起来、go mod init 能成功执行，就是搭好了——不需要 GOPATH、不强求特定目录结构、也不用先配代理才能起步。
go version 验证失败？先盯住 PATH 和终端重启
安装完 go 后执行 go version 报 “command not found”，不是 Go 没装好，而是 shell 找不到它。macOS/Linux 用户常漏掉这步：安装 pkg 或 tar.gz 后，/usr/local/go/bin 必须显式加进 PATH；Windows 用户若没勾选 “Add Go to PATH”，也要手动改系统环境变量。
- 检查是否生效：
echo $PATH里得有/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows） - 改完配置文件（如
~/.zshrc）后，必须新开终端，或者运行source ~/.zshrc - VS Code 用户注意：如果从图形界面启动 VS Code，它可能不继承 shell 的
PATH，建议从终端执行code .启动
go mod init 不报错但 go.mod 为空？你可能在 GOPATH/src 里执行了
Go 1.11+ 默认启用模块模式，但若当前路径在旧式 $GOPATH/src 下，go mod init 会静默退化为 GOPATH 模式，生成的 go.mod 文件可能只有一行 module 声明，没有 go 版本和依赖项。
- 直接新建一个空目录（比如
~/projects/myapp），不要进$GOPATH/src或任何已有 Go 项目子目录 - 执行
go mod init myapp（模块名可以是任意合法导入路径，不一定要联网可解析） - 成功后
go.mod至少包含两行：module myapp和go 1.23（版本号随你本地 Go 版本自动填入）
go get 卡住或超时？先试 go env -w GOPROXY=direct
刚初始化模块就跑 go get github.com/gin-gonic/gin 却卡在 “Fetching” 或报 x509: certificate signed by unknown authority，大概率是代理或证书问题。别急着配 goproxy.cn，先用最简方式验证基础链路：
- 临时禁用代理：
go env -w GOPROXY=direct - 再试一次
go get，如果成功，说明是代理配置问题；如果仍失败，问题出在 DNS、防火墙或公司网络策略 - 确认后再开代理：
go env -w GOPROXY=https://goproxy.cn,direct - 注意：Go 1.21+ 默认开启模块模式，
GO111MODULE=on已非必需，不用再手动设
VS Code 提示 “gopls is not installed”？别点“Install All”硬等
打开 .go 文件后底部弹出 “Installing tools”，点击 “Install All” 却一直转圈甚至失败，是因为部分工具（如 dlv、gopls）需编译，对网络和权限敏感。
- 手动触发更可控：
go install golang.org/x/tools/gopls@latest - 调试器单独装：
go install github.com/go-delve/delve/cmd/dlv@latest - 装完后，在 VS Code 命令面板（
Cmd+Shift+P）运行 “Go: Restart Language Server” - 如果提示权限错误（尤其 macOS），检查
go env GOCACHE是否指向可写路径，必要时go env -w GOCACHE=$HOME/Library/Caches/go-build
真正容易被忽略的，是 go mod init 后首次 go run 或 go build 时，Go 会自动下载标准库以外的依赖并写入 go.mod 和 go.sum——这个过程无声无息，但一旦失败，后续所有命令都会卡住。与其反复重试，不如先确保 go env GOPROXY 和网络连通性真实有效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
