go命令找不到主因是path未包含go二进制路径，goroot需显式设置于非标准解压路径；模块缺失需同步pkg/mod目录结构；checksum mismatch因go.sum未同步；离线时goproxy必须设为direct。
go 命令找不到：PATH 和 GOROOT 没配对
离线机上敲 go version 报 command not found，90% 是因为解压后没把 /usr/local/go/bin（Linux/macOS）或 C:\Go\bin（Windows）加进 PATH。别只改 ~/.bashrc 就以为完事——zsh 用户得改 ~/.zshrc，Windows 得进「系统属性 → 高级 → 环境变量」里手动加，不能只在 CMD 里 set PATH=... 临时生效。
GOROOT 通常不用手设，但如果你解压到了非标准路径（比如 /opt/go-1.22.5），就得显式声明：export GOROOT=/opt/go-1.22.5
然后验证：go env GOROOT 输出必须和你设的一致。
第三方模块报 missing module：pkg/mod 目录结构错不得
离线机上 go build 提示缺模块，不是代码没拷过去，而是 $GOPATH/pkg/mod 下的目录层级被扁平化或路径拼错。Go 要求模块缓存严格按 domain.com/user/repo@v1.2.3 格式存放，例如：/home/user/go/pkg/mod/github.com/go-sql-driver/mysql@v1.10.0/
- 先在有网机器用目标项目的
go mod download拉全依赖，再打包整个$GOPATH/pkg/mod目录（保留所有子目录） - 离线机上确保
GO111MODULE=on（默认已启用），且go env GOPATH输出路径和你解压的位置一致 - 若模块是私有地址（如
git.internal.company/foo），还需额外运行：go mod edit -replace=git.internal.company/foo=../local-foo
checksum mismatch 卡住构建：go.sum 必须同步，不能只拷代码
明明 pkg/mod 里文件都在，却报 verifying github.com/xxx@v1.2.3: checksum mismatch，根本原因是 go.sum 缺失或哈希值不匹配。Go 不会信任“看起来像”的文件，它只认 go.sum 里记录的 SHA256。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 有网机器跑一次
go mod download后，go.sum会自动生成；务必连同go.mod一起拷到离线项目根目录 - 不要手动删
go.sum或用文本编辑器改里面的内容——哈希值是 Go 自动计算并校验的 - 如果离线机上曾执行过
go mod tidy，而当时没联网，它会清空go.sum，导致后续构建失败
离线场景下 GOPROXY 无意义，但 direct 必须显式保留
离线环境设 GOPROXY=https://goproxy.cn,direct 没用——所有请求都会 fallback 到 direct，但漏掉 direct 会导致 Go 默认行为变成 GOPROXY=off，进而拒绝读取本地 pkg/mod 缓存。
正确做法是明确设为：export GOPROXY=direct
这样 Go 才会跳过网络代理逻辑，直接查本地模块缓存。验证方式：go env GOPROXY 输出必须是 direct，不是空或 https://...。
容易被忽略的是：某些 CI 脚本或 IDE 插件会覆盖这个值，建议在离线机的 shell 配置文件里固定写死，并在每次打开终端后用 go env GOPROXY 确认。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
