根本原因是系统PATH未包含go可执行文件路径，不是安装失败；Linux/macOS需手动将/usr/local/go/bin加入PATH（如写入~/.zshrc），Windows需确认C:\Go\bin已添加至环境变量，并执行source或重启终端验证。
go二进制离线安装后为什么go version报command not found
根本原因是系统 PATH 没包含 go 可执行文件路径，不是安装失败。
- Linux/macOS：解压到
/usr/local/go后，必须手动把/usr/local/go/bin加入PATH（写入~/.zshrc或/etc/profile.d/golang.sh） - Windows：安装包默认不自动加
Path，需手动检查环境变量中是否含C:\Go\bin（或你自定义的安装路径 +\bin） - 验证方式不是只跑
go version，还要跑which go（macOS/Linux）或where go（Windows），确认输出路径指向你解压的位置
GOROOT 和 GOPATH 在离线环境中要不要设
绝大多数情况 GOROOT 不用设；GOPATH 是否设，取决于你用不用旧工具链或 CI 脚本。
-
GOROOT：仅当你解压多个 Go 版本（如/opt/go1.20、/opt/go1.22）且不想改 PATH 时才显式设置；设错会导致cannot find package "fmt" -
GOPATH：Go 1.21+ 已不强制要求，但若团队 CI 脚本、IDE 插件或老版dep工具仍依赖它，就得保留；建议设为~/go或统一内网路径（如/data/gopath），并确保src、bin、pkg目录存在 - 离线构建时，
go build不读GOPATH（模块模式下走go.mod），但它影响go install输出位置和部分工具行为
内网机器无法拉取依赖时 go mod vendor 怎么用才不翻车
go mod vendor 不是“一键打包”，它只复制当前 go.mod 解析出的依赖树，且默认跳过测试依赖和 replace 到本地路径的模块。
- 先确保有完整依赖缓存：在能联网的机器上运行
go mod download，再把整个$GOPATH/pkg/mod打包拷贝进内网（或直接同步vendor/目录） - 执行前务必
go mod tidy清理冗余项，否则vendor/里可能残留已删模块 - 必须加
-v参数：go mod vendor -v，否则静默失败时看不到缺了哪个包（比如某replace指向的内网 Git 仓库不可达） - CI 构建阶段要关代理：
GOPROXY=direct GOSUMDB=off go build，否则即使有vendor/，Go 仍会尝试连sum.golang.org
go build 时 vendor 目录没生效的常见原因
看到 vendor/ 目录却仍从 $GOROOT/src 或 $GOPATH/pkg/mod 加载包？那说明 vendor 没被启用。
立即学习“go语言免费学习笔记（深入）”；
- Go ≥1.11 默认走模块模式，
vendor/需配合GO111MODULE=off才生效；运行go env -w GO111MODULE=off（或临时GO111MODULE=off go build） - 检查当前目录是否在
$GOPATH/src下——旧式 vendor 模式强依赖此路径结构，否则会被忽略 - 运行
go build -v观察输出：只有出现vendor/字样（如vendor/github.com/sirupsen/logrus），才表示正在读 vendor；若打印的是$GOROOT/src/fmt或$GOPATH/pkg/mod/xxx@v1.2.3，说明 vendor 被绕过了
GOSUMDB=off 必须和 GOPROXY=direct 同时设置，否则 go build 卡在 checksum 校验；还有 IDE（如 VS Code 的 Go 插件）会缓存环境变量，改完得重启编辑器。 
