go环境装不起来90%是path未生效、goroot/gopath混淆或误用gopath/src，应先验证go env四关键项（gopath、goroot、goproxy、go111module），再检查path是否含正确bin路径、终端是否重载配置、模块模式下代码是否置于go.mod根目录。
Go 环境装不起来，90% 不是下载错了，而是 PATH 没加对、GOROOT 和 GOPATH 混了，或者 go mod 默认启用后还硬往 $GOPATH/src 里放代码。
go version 报 command not found？检查 PATH 是否真生效
安装完 go 后命令不可用，不是没装好，而是 shell 没读到新路径。Windows 用户常把 %GOROOT%\bin 加进系统变量却忘了重启终端；macOS/Linux 用户改了 ~/.zshrc 却没执行 source ~/.zshrc。
- Windows：运行
where go，若无输出，说明PATH未包含C:\Go\bin或你自定义的%GOROOT%\bin - macOS/Linux：运行
echo $PATH，确认输出里含/usr/local/go/bin（或你解压的路径） - 别信“安装程序自动配置”——MSI 安装器在某些 Win10/Win11 版本中会漏加
PATH，Homebrew 在升级后可能覆盖旧GOROOT
go env 显示 GOROOT 错误？别手动设 GOROOT
GOROOT 是 Go 安装根目录，官方安装包（.msi/.pkg/tar.gz）会自动推导并设置它。手动设 GOROOT 反而容易出错，尤其当你解压到非标准路径（如 D:\go）却忘了同步更新 PATH 中的 bin 子路径。
- 运行
go env GOROOT，正常应输出类似/usr/local/go（macOS/Linux）或C:\Go（Windows） - 如果输出为空或明显错误（如
/usr/local/opt/go/libexec但该路径下没有bin/go），说明GOROOT被错误覆盖，删掉环境变量里的GOROOT行，让 Go 自己识别 - 验证：直接运行
/usr/local/go/bin/go version（macOS/Linux）或C:\Go\bin\go.exe version（Windows），能成功则证明二进制本身没问题
go run main.go 报 package not found？go mod 已默认启用
Go 1.16+ 默认开启模块模式（GO111MODULE=on），此时 go run 不再从 $GOPATH/src 查找包，而是依赖当前目录是否有 go.mod 文件。还在用老教程把代码丢进 $GOPATH/src/hello/main.go？那必然失败。
- 新建项目目录（任意位置，比如
~/myapp），进入后运行go mod init myapp—— 这会生成go.mod，且后续所有go命令都以此为根 -
main.go必须放在该目录下（不能套子目录），且首行必须是package main - 如果项目依赖外部包（如
github.com/gorilla/mux），直接go run main.go会自动下载并写入go.mod和go.sum，无需先go get
依赖下载超时或校验失败？GOPROXY 和 GOSUMDB 必须配对调整
国内直连 proxy.golang.org 基本不可用，但只设 GOPROXY 不够——GOSUMDB 默认仍尝试校验官方 checksum 数据库，而国内镜像通常不提供该服务，导致 go get 卡住或报 verifying github.com/xxx@vX.X.X: checksum mismatch。
- 运行这两条命令（一次性生效）：
go env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=off - 不推荐用
sum.golang.org，它在国内同样不稳定；off是安全的，因为GOPROXY镜像本身已做完整性缓存 - 若公司内网有私有代理，把
https://goproxy.cn换成对应地址即可，GOSUMDB=off仍建议保留
最易被忽略的是：Go 安装后不要急着写代码，先跑 go env 看四行关键输出——GOPATH、GOROOT、GOPROXY、GO111MODULE，这四个值不对，后面所有操作都在打转。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
