Go环境搭建需分步验证：PATH配置后用which go确认，go mod需开启模块并设GOPROXY，编辑器需对齐gopls与GOROOT/GOPATH，dlv调试要签名、加构建标志且确保可执行。
Go环境搭建本身不难，但新手常在“看似装好了”和“真能用”之间卡住——核心问题不是不会装，而是没意识到 go 命令能跑 ≠ go mod 能拉包 ≠ dlv 能调试 ≠ 编辑器能识别类型。
go 命令识别不了？先盯死 PATH
这是最普遍的“假安装”：下载解压完、执行 /usr/local/go/bin/go version 成功，但直接敲 go version 报错 command not found。
- macOS（Zsh 默认）：编辑
~/.zshrc，加一行export PATH=$PATH:/usr/local/go/bin - Linux：同样加到
~/.bash_profile或/etc/profile，别忘了source ~/.bash_profile - Windows：在“系统属性 → 高级 → 环境变量”里把
C:\Program Files\Go\bin加进用户或系统PATH - 验证方式不是看安装目录有没有
go，而是新开一个终端后运行which go，输出路径必须包含/bin且和你配置的一致
go mod 下载失败？代理和模块开关必须手动开
国内用户几乎必踩：新建项目后 go mod init myapp 没问题，但一执行 go run main.go 就卡在 go: downloading golang.org/x/net v0.0.0-...，最终超时。
- 确认模块已启用：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧终端可能未刷新） - 必须设代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示私有域名不走代理） - 若用内网 Git（如
git.example.com），额外加：go env -w GOPRIVATE=git.example.com - 不要依赖 IDE 自动设置——VS Code 的 Go 扩展、GoLand 的 SDK 配置都可能绕过 shell 环境变量，务必在终端里先验证
go list -m all能否成功列出依赖
编辑器报“package not found”？gopls 和 GOPATH/bin 路径要对齐
VS Code 或 GoLand 里代码满屏红线，提示 cannot find package "fmt" 或 gopls not found，但终端里 go run 完全正常。
立即学习“go语言免费学习笔记（深入）”；
- 根本原因：编辑器启动的
gopls进程找不到go工具链，或找不到它自己 - 手动装
gopls：go install golang.org/x/tools/gopls@latest（注意是@latest，不是@master） - 确认
$GOPATH/bin在PATH中（哪怕你不用 GOPATH，go install默认仍往这儿放二进制） - VS Code 中检查设置：
go.goroot是否指向你的 Go 安装目录（如/usr/local/go），go.gopath是否与go env GOPATH输出一致 - 改完设置后必须点右下角 “Reload Window”，不能只重启终端
dlv 调试起不来？权限、签名、构建标志三连击
想在 VS Code 里打个断点，点击调试却弹出 could not launch process: fork/exec ... permission denied，或 macOS 上提示“已损坏，无法打开”。
- 先验证
dlv能不能用：go install github.com/go-delve/delve/cmd/dlv@latest，再运行dlv version - macOS 用户：若提示“已损坏”，需手动签名：
codesign -s - --entitlements=(pwd)/entitlements.plist --force $GOPATH/bin/dlv（Entitlements 文件需含com.apple.security.cs.debugger） - VS Code 启动调试前，
launch.json必须加构建禁优化标志，否则断点失效：{ "name": "Launch", "type": "go", "request": "launch", "mode": "auto", "program": "${workspaceFolder}", "env": {}, "args": [], "buildFlags": "-gcflags=all=-N -l" } - Linux/macOS 若报
permission denied，检查dlv文件是否可执行：ls -l $GOPATH/bin/dlv，必要时chmod +x $GOPATH/bin/dlv
真正卡住人的从来不是某一步不会做，而是错误信息分散在终端、编辑器弹窗、日志文件里，而你不知道该信哪一个。建议每配完一项，就用最简命令验证：比如配完 PATH 就关终端重开，配完 GOPROXY 就 go list -m golang.org/x/net，配完 dlv 就 dlv version —— 别跳步，也别假设“应该没问题”。
