离线go项目跑不起来根本原因是go二进制、标准库、依赖包、ide插件四者未版本对齐且路径不可信；必须确保goroot完整、go111module=off、vendor目录结构匹配、go.sum可信或删除，并禁用goproxy/gosumdb。
离线环境里 Go 项目跑不起来，根本不是“没网”这么简单——而是 go 二进制、标准库、依赖包、IDE 插件四者缺一不可，且必须版本对齐、路径可信、校验绕过。只拷个 GOROOT 目录过去，90% 的情况会卡在 import "fmt" 标红或 go run 报 “no Go files in current directory”。
确认离线机器上 go 二进制是否真正可用
别信 go version 成功就万事大吉。它只验证了可执行文件存在，不验证标准库和构建链路完整。
- 运行
go env GOROOT，输出路径必须指向一个**完整解压目录**（含src/、pkg/、bin/），不能是符号链接或精简版安装包 - 执行
go list std | head -n 3：若卡住、报错或输出为空，说明GOROOT/src损坏或权限异常（常见于 Windows 解压后属性被锁） - 检查
go env GOPATH：即使不用 GOPATH 模式，gopls和部分工具仍 fallback 到它；离线环境下建议显式设为$HOME/go并确保该路径可写
GO111MODULE=off 与 vendor/ 目录生效的硬条件
Go 1.11+ 默认启用模块模式，vendor/ 是被“降级兼容”的功能，不是开箱即用。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须在终端或 IDE 启动前设置
GO111MODULE=off（不是on或空字符串），否则go build完全无视vendor/ -
vendor/必须位于$GOPATH/src/<import-path></import-path>下，且项目 import 路径需与目录结构严格匹配（例如import "example.com/myapp"，则代码必须放在$GOPATH/src/example.com/myapp） - 运行
go build -v观察输出：只有看到类似vendor/example.com/somepkg的路径才表示 vendor 生效；若出现$GOROOT/src/fmt或$GOPATH/pkg/mod/，说明模块模式仍在接管
离线依赖打包：别手动 cp vendor/
go mod vendor 生成的 vendor/ 是带元数据和校验逻辑的产物，直接拷贝容易漏 .git、vendor/modules.txt 时间戳异常，导致后续 go mod vendor 重跑失败。
- 有网机器上先执行：
GO111MODULE=on && go mod download && go mod vendor，确保vendor/modules.txt完整 - 打包整个
vendor/目录（含隐藏文件），用tar -cf vendor.tar vendor/，别用资源管理器拖拽 - 离线机器解压后，立即运行
go mod vendor -v验证：它应快速完成，不 fetch、不报错；若提示checksum mismatch，说明缓存或文件损坏，需重打
GoLand / VS Code 离线插件启动失败的真实原因
IDE 标红、无法跳转、运行按钮灰掉，往往不是 Go 环境问题，而是语言服务器（gopls）卡在模块解析或校验阶段。
- 先关掉所有代理设置：
go env -w GOPROXY=off GOSUMDB=off，否则gopls会持续尝试连接 - VS Code 中不要点插件弹窗的 “Install All”，改用命令面板（
Ctrl+Shift+P）运行Go: Install/Update Tools，只勾选gopls单独安装 - GoLand 需手动指定 SDK：Settings → Go → GOROOT → 点 “+” 添加本地完整
GOROOT路径，**不能依赖 PATH 查找**——内网机器上which go可能指向旧版本
最容易被忽略的是：离线环境里 go.sum 文件必须存在且内容可信。如果它是从有网环境带过来的，但后续又执行过 go mod tidy（即使没网），Go 会尝试更新 go.sum 并失败，进而阻断整个构建流程。稳妥做法是，离线项目中把 go.sum 设为只读，或干脆删掉（前提是确认所有依赖都已进 vendor/ 且 GO111MODULE=off 已生效）。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
