go version返回版本号但提示command not found，说明go命令不在PATH中，即使二进制存在也找不到；常见于手动解压安装后未配置PATH，或Windows安装时“Add to PATH”未实际生效。
go version 返回版本号但提示 command not found
说明 go 命令不在系统 PATH 中，即使二进制存在也找不到。常见于手动解压安装后没改 PATH，或 Windows 安装时勾选了“Add to PATH”但实际未生效（尤其多用户环境或 PowerShell 与 CMD 环境变量不一致）。
检查方法：which go（Linux/macOS）或 where go（Windows CMD），若无输出即路径未生效。
修复建议：
• Linux/macOS：确认 ~/.bashrc 或 ~/.zshrc 中有 export PATH=$PATH:/usr/local/go/bin（或对应 GOROOT 下的 bin 路径），然后运行 source ~/.zshrc；
• Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」中检查 Path 是否包含 C:\Go\bin（MSI 默认路径）或你自定义的 go\bin 目录，修改后需重启终端。
go env 显示 GOROOT 为空或路径错误
GOROOT 应指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），不是工作区路径。如果为空或指向 $HOME/go 这类明显是 GOPATH 的位置，说明 GOROOT 被误设或未设。
影响：某些跨平台构建、交叉编译或依赖 GOROOT 的工具（如 go tool dist）会失败。
修复建议：
• 不要手动设置 GOROOT —— 大多数情况下 go 可自动推断；
• 若必须显式设置（如多版本共存），确保值为纯安装路径，不含 /bin；
• 检查是否在 shell 配置中写了类似 export GOROOT=$HOME/go 这种错误赋值，删掉它；
• 运行 go env -w GOROOT="/usr/local/go"（Linux/macOS）或 go env -w GOROOT="C:\Go"（Windows）强制写入，再 go env GOROOT 验证。
go run hello.go 成功但 go build 后执行报错 missing symbol
这通常不是环境问题，而是 Go 版本兼容性或构建模式差异导致。例如在较新 Go 版本下用 go build 编译出的二进制，在旧内核（如 CentOS 7）上运行可能因缺少 GLIBC_2.28+ 报错；或者用了 //go:build 条件编译但未正确识别目标平台。
更隐蔽的问题是：当前目录未初始化模块（go mod init），却引用了非标准库包（比如 golang.org/x/sys），此时 go run 会隐式下载并缓存，但 go build 在无 go.mod 时可能忽略 vendor 或 proxy 配置，导致链接失败。
验证建议：
• 先运行 go mod init example.com/hello 初始化模块；
• 再执行 go build -o hello .；
• 若仍失败，加 -ldflags="-s -w" 减少符号依赖，或用 go build -a -ldflags="-linkmode external -extldflags '-static'" 尝试静态链接（需 gcc 支持）；
• 检查 go env GOOS 和 GOARCH 是否与目标运行环境一致。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
go mod download 失败或超时
这不属于“环境搭建失败”，但属于开发链路卡点，常被误判为配置问题。本质是网络或代理设置问题，而非 go 命令本身异常。
典型现象：go mod download 卡住、返回 Get "https://proxy.golang.org/..." : dial tcp: i/o timeout 或 403 Forbidden。
解决路径：
• 先确认是否设置了 GOPROXY：运行 go env GOPROXY，预期应为 https://proxy.golang.org,direct 或国内镜像（如 https://goproxy.cn）；
• 若为空或错误，运行 go env -w GOPROXY=https://goproxy.cn,direct；
• 若公司内网禁外网，需配合 no_proxy 设置，例如 export NO_PROXY="goproxy.cn,127.0.0.1"；
• 注意：某些 IDE（如 VS Code）会读取自己的环境变量，需在 IDE 启动前设置好，或在 IDE 设置中指定 GOPROXY；
• 最后验证：新建空目录，go mod init test，再 go get github.com/sirupsen/logrus@v1.9.0，看能否拉取成功。
立即学习“go语言免费学习笔记（深入）”；
真正卡住环境验证的，往往不是命令跑不起来，而是 PATH、GOROOT、GOPROXY 这三处看似简单却极易手误的配置项。尤其当多个 shell 配置文件（.bashrc、.zshrc、/etc/profile）混用时，改了 A 文件却在 B 终端里测试，结果就是“明明写了却没生效”。 
