优先怀疑GoLand缓存损坏：若go list -m all正常且含依赖包、IDE长时间索引或External Libraries为空、Go Modules设置灰显，则删.idea后重启重索引即可恢复。
GoLand 报 import 红波浪但 go build 成功，怎么判断是不是依赖包缓存损坏
IDE 报红 ≠ 依赖真丢了。GoLand 用的是自己的模块索引和 gopls 语言服务器，和 go build 的解析路径不完全一致。常见表现是：代码里 import "github.com/sirupsen/logrus" 下划红线，但终端执行 go run main.go 正常通过。
这时优先怀疑不是代码问题，而是 GoLand 的本地索引或模块缓存错位。尤其当以下情况同时出现时，基本可锁定为缓存损坏：
-
go list -m all在终端输出完整、无报错，且含你引用的包（如github.com/sirupsen/logrus v1.9.0） - GoLand 底部状态栏显示 “Indexing…” 长时间不动，或反复重索引
- 项目结构视图（Project Tool Window）中
External Libraries下为空或只显示GOROOT - Settings → Go → Go Modules 页面里，“Vendor directory” 或 “Use vendor directory” 设置被灰掉
删 .idea 不是删项目，而是让 GoLand 重建模块元数据
GoLand 把项目结构、模块路径映射、运行配置等全记在 .idea 文件夹里。它不参与构建，但决定 IDE 能不能“看见”你的依赖。一旦这个目录损坏（比如 Git 拉取时漏了部分文件、手动改过 modules.xml、或升级后兼容异常），就会导致依赖识别失败。
安全操作流程如下：
- 关闭 GoLand（别只关窗口，要彻底退出进程）
- 进项目根目录，删掉整个
.idea文件夹（Windows 下注意隐藏属性） - 用
File → Open重新打开该目录（不要双击.go文件，也不要从 Open Recent 进） - 等待索引完成（右下角提示 “Indexing finished”），再检查 Project 视图和 import 是否恢复
注意：.idea 不在版本控制里是合理设计，删它不会影响代码或 go.mod；但如果你改过 Run Configuration，这些自定义配置会丢失，需重设。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
go mod tidy 失败时，先禁用 GOPROXY 再重试
GoLand 构建失败常卡在依赖下载环节，错误日志里出现 no required module provides package 或 unknown revision，大概率不是包真没了，而是代理链出问题——比如 GOPROXY 指向的镜像源响应超时、返回空、或校验失败。
临时绕过代理验证最直接：
- 在 GoLand Terminal 中执行：
GOPROXY=direct go mod tidy - 如果成功，说明原
GOPROXY配置不可靠；可永久修复为go env -w GOPROXY=https://goproxy.cn,direct - 若仍失败，检查
go.mod里是否有私有路径（如gitlab.example.com/group/lib），确认该 Git 服务可达，或用go mod edit -replace=...指向本地路径 - 别跳过
go.sum：它缺失或哈希不匹配会导致go mod tidy静默跳过某些间接依赖，必须存在且未被篡改
vendor 目录失效时，go build -mod=vendor 不是可选项，是强制要求
很多人以为生成了 vendor/ 就万事大吉，结果 go build 依然联网失败。根本原因是 Go 默认仍会校验 go.sum 并尝试连接 sum.golang.org，哪怕 vendor 已就位。
必须显式声明两个条件：
- 构建命令加
-mod=vendor参数：go build -mod=vendor（go run和go test同理） - 禁用 sumdb 校验（仅限离线或可信环境）：
GOSUMDB=off go build -mod=vendor - 确保
go.sum文件存在且内容完整——它被删后go mod tidy会重建，但首次重建需联网拉取所有哈希值
vendor 不是银弹。它解决的是“依赖可复现”，不是“IDE 索引自动恢复”。GoLand 仍需正确识别 vendor/ 为模块根，这依赖 .idea/modules.xml 里的配置，所以删 .idea 后重开仍是关键一步。
