GOROOT必须指向本地已解压、含bin/go的Go安装根目录，否则go命令失效、GoLand报“Go SDK not found”；需确保路径无尾部反斜杠、不指向bin子目录，并配置GO111MODULE=on和GOPROXY=direct以保障离线构建。
GOROOT 必须离线可定位，否则 go 命令直接失效
GoLand 启动时若找不到 go 二进制，会报 “Go SDK not found” 或在 Run 配置里灰显 “No SDK configured”。这和网络无关，只取决于 GOROOT 是否指向一个**本地已解压、含完整 bin/go 的 Go 安装目录**。
常见错误现象：
-
go version在命令行能运行，但在 Goland 里提示 SDK 缺失 - Goland 设置里手动指定
GOROOT路径后仍报错，实际是路径末尾多了反斜杠（如D:\go\）或指向了bin目录而非根目录
实操建议：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认 Go SDK 已下载为离线包（如
go1.23.1.windows-amd64.zip），解压到本地固定路径（如D:\golang\1.23.1），该路径下必须存在bin\go.exe - 在 Windows 系统变量中新建
GOROOT，值填D:\golang\1.23.1（不带尾部反斜杠） - 将
%GOROOT%\bin加入Path—— 这一步确保命令行和 Goland 内置终端都能调用go
GO111MODULE=on 是离线构建的前提，不是可选项
离线环境下，go mod download 必然失败，但只要项目已有 go.mod 和 go.sum，且依赖已缓存，go build 仍可工作。前提是模块模式必须强制启用，否则 Go 会退回到 GOPATH 模式并尝试从网络拉取包。
常见错误现象：
- 执行
go build报错go: modules disabled，即使有go.mod - Goland 右下角显示 “Modules disabled”，代码补全和跳转失效
实操建议：
- 在无网络前，用有网环境执行：
go env -w GO111MODULE=on（写入用户级配置，持久生效） - 验证：断网后运行
go env GO111MODULE，输出必须是on，不是auto或空 - 若误设为
auto，Goland 在离线时可能因无法探测vendor或go.mod位置而降级行为
GOPROXY=direct 是离线唯一安全的 fallback
即使设置了 GO111MODULE=on，默认 GOPROXY 是 https://proxy.golang.org,direct。断网后，Go 会先尝试连接代理，超时后才走 direct。这个超时（默认 30 秒）会导致 go build 卡住、Goland 的依赖索引停滞、甚至 IDE 假死。
实操建议：
- 离线前务必执行：
go env -w GOPROXY=direct - 不要留任何逗号分隔的 fallback（如
https://goproxy.cn,direct），direct必须单独存在 - 验证：断网后运行
go env GOPROXY，输出应严格为direct - 注意：此设置仅影响
go get和go mod download；只要本地已有 module cache（$GOCACHE下的download子目录），go build不依赖网络
GOCACHE 和 GOMODCACHE 必须指向本地可写路径
离线构建依赖编译缓存（GOCACHE）和模块缓存（GOMODCACHE）。如果这两个路径被设为网络映射盘、只读位置或权限受限目录，Goland 构建会静默失败或反复重编。
常见错误现象：
- 首次
go build成功，第二次却重新编译全部依赖（缓存未命中） - Goland 提示 “Build failed: no output” 但无具体错误
-
go list -m all输出大量(incompatible)或路径混乱
实操建议：
- 显式设置
GOCACHE为本地磁盘绝对路径（如E:\go-cache），避免默认落在%LOCALAPPDATA%下导致权限问题 - 显式设置
GOMODCACHE（如D:\go-modcache），它独立于GOPATH，且不会被go clean -modcache影响已有离线包 - 检查路径是否可写：在 CMD 中执行
echo test > E:\go-cache\test.txt && del E:\go-cache\test.txt
离线环境最易被忽略的点是：Goland 的“自动检测 GOPROXY”行为不可信——它可能在启动时尝试 DNS 解析，导致界面卡顿数秒；而真正决定构建成败的，只有 GOROOT 的物理存在性、GO111MODULE=on 的强制性、以及 GOPROXY=direct 的绝对性。其他变量都是加速项，不是保命项。
