GoLand离线正常运行需彻底断网并确保模块文件物理存在；GOROOT须指向完整Go解压目录；必须启用vendor模式且vendor/modules.txt存在；GOPROXY=off和GOSUMDB=off须设为系统级环境变量。
GoLand 在离线环境下能正常识别依赖、不卡在 “Loading modules” 的前提，不是靠“让它连上什么”，而是**彻底切断它所有联网路径，并确保它要找的每个模块文件都已物理存在且路径可读**。只设 GOPROXY=off 或只拷贝 go.mod 是不够的——IDE 会静默等待、不报错、也不继续。
GOROOT 必须指向完整解压目录，不能只选 bin/
GoLand 不自带 Go 编译器，它只调用你指定的 GOROOT 下的 bin/go。如果离线机上只拷了 go.exe 或把 GOROOT 设成 C:\go\bin，IDE 启动后会报 Cannot find Go SDK，终端里运行 go version 直接提示 command not found。
- 在联网机下载官方二进制包（如
go1.22.5.linux-amd64.tar.gz），解压后整个go文件夹（含bin/、src/、pkg/）拷到离线机固定路径，例如/usr/local/go或C:\go - GoLand 中设置：
Settings → Go → GOROOT → + →选中/usr/local/go（不是子目录） - 验证：
go env GOROOT输出必须和设置路径完全一致；再跑go version看是否返回带架构的版本号
vendor 模式必须启用，且 vendor/modules.txt 必须存在
GoLand 默认启用 Modules，打开项目时自动触发 go mod download。离线状态下它不会报错，只会无限等待 proxy.golang.org——这是最隐蔽的卡顿点。GOPROXY=direct 不够，因为 vendor 模式本身要被显式激活。
- 在联网机、用**完全相同版本**的 Go（如
go1.22.5）进入项目根目录，依次执行：go mod tidy→go mod vendor - 确认生成了
vendor/目录，且里面包含vendor/modules.txt（这是 vendor 是否生效的关键元数据） - 把整个项目（含
go.mod、go.sum、vendor/）整体拷贝到离线机，不要只复制源码 - GoLand 中需手动开启 vendor 支持：
Settings → Go → Go Modules → Vendoring mode → Enabled；否则 IDE 仍走pkg/mod
GOPROXY=off 和 GOSUMDB=off 必须设为系统级环境变量
只在命令行前缀写 GOPROXY=off go build 是无效的。GoLand 内置终端、git hook、CI 脚本等子进程不会继承临时变量，它们仍会尝试解析域名或连接 sumdb，导致静默失败或超时。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Linux/macOS：在
~/.zshrc或~/.bashrc中添加：export GOPROXY=off、export GOSUMDB=off - Windows PowerShell：
$env:GOPROXY="off"、$env:GOSUMDB="off" - 验证：
go env GOPROXY和go env GOSUMDB都应输出off，而非https://...或空值 - 注意：
GOSUMDB=""仍可能 fallback 到默认值；必须是off才真正跳过校验
离线构建失败时，优先检查 vendor/ 是否覆盖全部间接依赖
go mod vendor 后仍编译失败的典型原因是：vendor/ 目录看似完整，但 Go 构建时仍可能去 $GOPATH/pkg/mod 查间接依赖或校验和，尤其当项目含 replace 指向私有路径或本地模块时。
- 执行顺序不能错：
go mod tidy→go mod vendor→git add vendor/；漏掉tidy，vendor/modules.txt会缺失// indirect条目 -
vendor/不包含replace的本地路径模块，这些必须手动拷贝进vendor/并同步更新go.mod - 含 cgo 的包（如
net、os/user）即使 vendor 了，离线机也需装gcc、libc6-dev，否则报cannot find -lc
最容易被忽略的一点是：GoLand 的 vendor 模式开关藏得深，且一旦没开，它就永远卡在后台加载状态，不提示、不报错、也不阻塞编辑——你只能靠 go build 命令行是否秒出结果来反推配置是否真生效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
