根本原因是系统path未包含go/bin目录，需将/usr/local/go/bin加入path并source配置文件；goroot和gobin通常无需手动设置；goproxy应设为清华镜像并保留direct回退；checksum mismatch优先清理modcache和go.sum。
Go二进制包解压后为什么go version报“command not found”
根本原因是系统找不到go可执行文件，不是安装失败，而是$PATH没包含go/bin目录。
典型操作是把下载的go1.22.5.linux-amd64.tar.gz解压到/usr/local：
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz
此时go命令实际在/usr/local/go/bin/go，必须让shell知道这个路径：
- 临时生效（仅当前终端）：
export PATH=$PATH:/usr/local/go/bin - 永久生效：把上面那行加到
~/.bashrc或~/.zshrc（取决于你用的shell），然后source ~/.bashrc - 验证：
which go应输出/usr/local/go/bin/go，再运行go version
常见坑：改完.bashrc没source，或者误加到了/etc/profile但权限/生效范围不对；还有的用户把GOROOT设成/usr/local/go却忘了同步更新PATH，这两者必须一致。
要不要手动设置GOROOT和GOBIN
Go 1.19+ 默认能自动推导GOROOT（只要go命令本身路径规范），绝大多数情况不用显式设置。
GOBIN更不建议手动设——它控制go install生成的二进制存放位置，设错会导致工具装到奇怪路径、后续调用不到。
- 默认行为最稳妥：
GOROOT由go自己找，GOBIN为空时自动落在$GOPATH/bin（而$GOPATH默认是$HOME/go） - 只有当你把Go安装到非标准路径（比如
$HOME/sdk/go）且PATH已正确配置，才需要加export GOROOT=$HOME/sdk/go - 如果真要改
GOBIN，务必确保该目录在PATH中，否则装完的工具（如gopls、delve）会“失踪”
国内环境下go get超时或403，怎么配GOPROXY
直接原因是模块代理不可达。Go 1.13+ 默认启用了代理，但官方proxy.golang.org在国内不稳定，必须换源。
推荐用清华镜像（稳定、同步快）：
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct
注意逗号后的direct不能少——它表示当代理返回404时回退到直连，避免私有模块拉不到。
- 验证是否生效：
go env GOPROXY应输出上面那串URL - 如果公司有私有模块仓库，可在
direct前追加内部代理，例如：https://intra.example.com/goproxy,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 临时覆盖（单次命令）：
GOPROXY=https://goproxy.cn go get github.com/some/pkg
别用过期的代理地址（比如已停服的goproxy.io），也别把GOPROXY设成off——这会禁用所有代理，直连sum.golang.org大概率失败，还可能触发校验错误。
go mod download失败提示“checksum mismatch”，是代理问题还是缓存污染
通常是本地go.sum记录与代理返回的模块哈希不一致，原因多为缓存残留或代理同步延迟，不是代码本身问题。
优先清缓存再重试：
- 删掉模块缓存：
go clean -modcache（会清空$GOCACHE和$GOPATH/pkg/mod下的所有模块） - 删掉项目里的
go.sum，再跑go mod tidy重新生成 - 检查
go env GOSUMDB——国内建议设为off（go env -w GOSUMDB=off），避免校验服务器不可达导致失败
如果只在某个模块出问题，可能是该模块在代理侧尚未同步最新tag，可临时切到direct模式验证：GOPROXY=direct go mod download example.com/repo@v1.2.3。但生产环境不建议长期关校验。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
