GoLand import标红但程序可运行，主因是索引缓存与模块元数据缓存未彻底清理，需手动删除Caches目录、index子目录及go-build缓存，并重启后执行go mod tidy重建依赖索引。
GoLand 缓存清理不彻底会导致 import 标红、跳转失效
GoLand 的索引缓存（Index Cache）和模块元数据缓存（Go Modules cache）是分开存储的，只删 ~/Library/Caches/JetBrains/GoLand2025.1 或只点 Settings → File → Invalidate Caches and Restart，往往清不干净。尤其当项目从 GOPATH 迁移到 Go Modules 后，旧缓存残留会持续干扰包路径解析。
实操建议：
- 先在 GoLand 中执行 Invalidate Caches and Restart → Just Restart（不要选 “Invalidate and Restart”，它不清理磁盘缓存）
- 再手动删除三处关键路径：
–~/Library/Caches/JetBrains/GoLand2025.1
–~/Library/Caches/JetBrains/GoLand2025.1/index（索引核心目录，单独删更准）
–~/Library/Caches/go-build（Go 自身构建缓存，影响go build行为，IDE 内部调用也会读它） - 重启后，打开 Terminal，运行
go mod tidy，强制刷新模块依赖树——这步能触发 GoLand 重新扫描go.mod并重建符号索引
第三方库 import 标红但 go run main.go 正常？检查 GOPROXY 和模块启用状态
常见现象：代码里写 import "github.com/gin-gonic/gin"，GoLand 下划线标红，但终端里 go run main.go 能跑通。这不是 IDE 坏了，而是 GoLand 没拿到模块元数据，或代理配置没生效。
关键检查点：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 终端执行
go env GOPROXY，确认返回值包含有效代理（如https://goproxy.cn,direct），不是空或off - GoLand 中 Settings → Go → Go Modules → 勾选
Enable Go Modules integration，且下方Environment输入框填的 GOPROXY 必须和终端一致（注意：这里不继承系统环境变量，必须显式填写） - 项目根目录必须存在
go.mod文件；若没有，先在 Terminal 运行go mod init example.com/yourproject，再go mod tidy - 禁用 “Auto-import” 相关插件（Settings → Plugins → 搜索 “Auto Import” → 取消勾选），某些第三方插件会劫持 import 补全逻辑，导致识别错乱
go mod vendor 后 GoLand 仍找不到包？vendor 目录未被 IDE 识别
执行 go mod vendor 生成了 vendor/ 目录，但 GoLand 还是报 cannot find package。这是因为 GoLand 默认不自动启用 vendor 模式，需手动切换解析策略。
解决方法：
- Settings → Go → Go Modules → 找到
Vendor directory选项，勾选Enable vendoring，并在路径框中填入vendor（相对路径即可，不用绝对路径） - 确保
go env GO111MODULE是on（不是auto），否则vendor/在模块模式下可能被忽略 - 删掉
go.sum和vendor/，重新执行go mod vendor—— 有些旧版go mod vendor会漏掉间接依赖，重生成更可靠 - 注意：启用 vendor 后，GoLand 不再走
$GOCACHE/pkg/mod，所有包解析都基于vendor/目录，此时修改vendor/github.com/xxx里的源码，IDE 才能实时响应
依赖下载成功但结构体/函数无法跳转？检查 Go SDK 和索引范围
明明 go mod tidy 显示 gin@v1.12.0 已下载，go list -m all 也能看到，但 Ctrl+Click 结构体名却跳不到定义，或者补全列表里没有 gin.H。问题大概率出在 SDK 绑定或索引粒度上。
排查步骤：
- Settings → Go → GOROOT → 确认选中的是你本地安装的 Go SDK（如
/usr/local/go），不是空、不是旧版本路径；GoLand 不会自动识别go version返回的路径，必须手动指定 - 右键项目根目录 → Mark Directory as → Sources Root（确保 IDE 知道哪是主模块起点）
- 如果项目含多个 module（比如
api/、server/各有go.mod），需在 Settings → Go → Modules 中点击+ Add，逐个添加子模块路径，否则 GoLand 只索引第一个go.mod - 最后执行一次
File → Reload project（不是 Restart），强制重载模块结构和符号表
