go version报“command not found”并非未安装，而是PATH未生效，尤其在非登录shell中；需将Go解压至/usr/local，通过/etc/profile.d/golang.sh系统级配置GOROOT、GOPATH及PATH，并验证go env GOROOT输出正确路径。
go二进制包解压后为什么go version报command not found
不是没装好，是PATH没生效——尤其在非登录shell（比如CI脚本、IDE内嵌终端）里，~/.bashrc或~/.zshrc根本不会被读取。必须用系统级配置确保所有子进程都能继承。
- 解压到固定路径：
sudo tar -C /usr/local -xzf go1.22.3.linux-amd64.tar.gz - 写入
/etc/profile.d/golang.sh，内容为：export GOROOT=/usr/local/go export PATH=$GOROOT/bin:$PATH export GOPATH=$HOME/go export PATH=$GOPATH/bin:$PATH
- 验证：新开终端，运行
go env GOROOT；若输出/usr/local/go才真正生效
离线时go build报module github.com/golang/net@latest found but does not contain package
这不是网络问题，是golang.org/x/等标准扩展模块没随主包一起带进来。它们不在go$VERSION.$OS-$ARCH.tar.gz里，必须单独下载并放进模块缓存目录。
- 联网机器上执行：
go mod download -x golang.org/x/net golang.org/x/sys golang.org/x/text - 打包整个
$GOPATH/pkg/mod目录（保留golang.org/x/net@v0.28.0这类带版本号的子目录结构） - 离线机上解压到
$GOPATH/pkg/mod，确保go list -m all能列出全部依赖 - 若仍报错，加构建参数：
go build -mod=readonly -modcacherw，避免Go试图校验或只读挂载导致失败
go mod vendor后离线编译仍提示missing module
vendor不是万能的——如果vendor/modules.txt里漏了// indirect标记的间接依赖，或者go.sum缺失/哈希不匹配，Go会直接拒绝构建。
- 联网机器上先跑：
GO111MODULE=on go mod download && go mod vendor - 检查
vendor/modules.txt是否覆盖全部go list -m all输出项，特别留意带// indirect的行 - 把整个
vendor/目录连同项目根目录下的go.mod和go.sum一起拷贝到离线机 - 离线构建时显式启用vendor：
go build -mod=vendor，否则Go默认忽略vendor目录
GOPROXY=direct和GOSUMDB=off为什么还不够
设了这两个环境变量只是绕过代理和校验，但Go仍会读go.sum并比对本地模块哈希。如果go.sum里记录的哈希与你放进去的模块文件实际哈希不一致，就会报错“checksum mismatch”。
立即学习“go语言免费学习笔记（深入）”；
- 最稳做法：离线前在联网机器上完整跑一次
go mod download，再打包$GOPATH/pkg/mod，这样go.sum和缓存内容天然匹配 - 若已离线且
go.sum不准，临时方案是删掉go.sum，再用go mod init && go mod tidy重生成（仅限可信代码） - 永远别只拷模块源码而不带
go.mod和go.sum——Go认的是模块元信息，不是文件存在与否
go.sum哈希一致性、以及-mod参数的实际生效时机——三者缺一，go build就卡在第一行错误里不动。 
