必须关闭GoLand“Build project automatically”功能，因其依赖联网执行go list解析依赖；离线时应手动运行go run或配置Run Configuration，并确保GOCACHE、GOMODCACHE环境变量正确设置且gopls已同步生效。
GoLand 无法离线自动构建，关掉它更合理
GoLand 的 Build project automatically 功能不是“离线构建开关”，而是每次保存都触发 go list 和 go build 检查——它必须联网或至少能访问本地模块缓存才能完成依赖解析。离线状态下它会卡在“正在分析…”、报 go list failed 或反复重试，反而拖慢编辑体验。
这个功能本质是为即时语法/类型错误反馈服务的，不生成可执行文件，也不等价于 go run。如果你需要离线运行代码，应该手动在 Terminal 执行 go run main.go 或配置 Run Configuration；自动构建只负责“检查”，不负责“交付”。
- 关闭路径：
Settings → Go → Build Tags & Vendoring → Build project automatically - 顺手关掉
Settings → Tools → File Watchers里所有 Go 相关 watcher（如go fmt），它们在离线时同样会失败并堆积日志 - 保留
gopls语言服务器：它不依赖网络，只要$GOCACHE和$GOMODCACHE里有已编译包和模块源码，就能提供跳转、补全、hover 等核心能力
本地缓存怎么让 GoLand 真正用上？关键看三个环境变量
GoLand 自身不管理缓存路径，它完全依赖 Go 工具链读取的环境变量。只改 IDE 设置没用，go env GOCACHE 和 go env GOMODCACHE 必须输出你期望的路径，否则缓存还是往 C 盘塞。
验证方式很简单：在 GoLand 内置 Terminal 里直接运行 go env GOCACHE 和 go env GOMODCACHE，两个都得是你设的本地路径（比如 D:\GoCache\build 和 D:\GoCache\mod），否则重启 IDE 也白搭。
-
GOCACHE：存编译中间产物（.a、.o），影响构建速度；设错会导致每次保存都重新编译标准库 -
GOMODCACHE：存模块源码解压副本（如github.com/gofiber/fiber/v2@v2.45.0），影响go mod download和go list是否离线可用 -
GOBIN（可选）：存go install的二进制，避免和GOROOT/bin混在一起；设为D:\GoCache\bin更干净
离线时 go list 报错？检查 gopls 是否在读旧缓存
即使 GOMODCACHE 已指向本地目录，gopls 仍可能因缓存路径未同步而 fallback 到空模块状态，表现为 import 不高亮、go.mod 显示“no modules found”、跳转失效。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
这不是缓存没生效，而是 gopls 启动时没拿到正确的环境。GoLand 默认 fork 子进程调用 gopls，它不继承你在 Terminal 里 export 的变量，必须设系统级环境变量，并重启 GoLand。
- Windows：用户环境变量中新增
GOMODCACHE，值为绝对路径（如D:\GoCache\mod），目录需提前创建且可读写 - macOS/Linux：写入
~/.zshrc或~/.bash_profile，加export GOMODCACHE="/path/to/mod"，然后source ~/.zshrc - 改完后务必重启 GoLand，再进 Terminal 运行
go env GOMODCACHE确认输出正确
清理缓存后离线跑不起来？别漏了 go mod verify
执行过 go clean -modcache 后，go list 或 go build 第一次会拉依赖，但若你中途断网，或想确保本地模块完整可用，不能只靠 go mod download —— 它只下缺失模块，不校验已有模块是否损坏。
go mod verify 才是离线可用性兜底操作：它比对 go.sum 中的 checksum 和 $GOMODCACHE 下对应模块的实际内容，失败则报 verified sum mismatch，说明缓存已损坏，必须重下。
- 建议在清理缓存后、断网前运行一次：
go mod verify - 如果失败，就只重下问题模块：
go mod download github.com/xxx@v1.2.3，不用全量-modcache - 注意：
go clean -cache不影响go mod verify结果，它只管编译产物，不管源码完整性
真正离线可用的关键，不是让 IDE “假装能构建”，而是让 gopls 和 go 命令在无网络时仍能复用本地缓存。环境变量设错、IDE 未重启、go mod verify 漏检——这三个点最容易被跳过，一卡就是半天。
