GoLand索引卡在“indexing…”的根源是缓存配置不合理：goland.vmoptions内存过低、vendor未排除、go.work支持未启用三者叠加所致；需调高JVM堆内存至-Xms2g -Xmx4g、排除vendor目录、启用go.work支持、清理GOCACHE和GOMODCACHE、限制索引范围并配置GOPROXY。
GoLand 索引卡在 “indexing…”、CPU 拉满但无报错，不是代码问题，而是缓存配置不合理——特别是 goland.vmoptions 内存设置过低 + vendor 目录未排除 + go.work 支持未启用，三者叠加会让索引时间从几秒拖到十几分钟。
调高 JVM 堆内存并禁用 G1GC
默认 -Xmx 通常只有 2g，大型 Go 项目（尤其含 vendor 或多 use 目录）很快触发频繁 GC，表现为光标延迟、文件打开慢、索引停滞。
- 关闭 GoLand，编辑
goland.vmoptions（路径见知识库，按系统区分） - 将
-Xms和-Xmx设为-Xms2g和-Xmx4g（物理内存 ≤ 16g 时适用；若 ≥ 32g，可设-Xmx6g，但不建议再高） - 添加
-XX:ReservedCodeCacheSize=512m，防 JIT 编译退化拖慢索引 - 删掉所有含
-XX:+UseG1GC的行——GoLand 官方明确不推荐手动指定 GC 策略
排除 vendor 目录并启用 go.work 支持
vendor 被默认当作源码目录扫描，每次保存都会触发全量 vendor 增量索引；而旧版 GoLand 对 go.work 解析错误，会为每个 use 子目录重复建 module，导致索引爆炸。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在 Settings → Directories 中，右键
vendor目录 → Mark as Excluded - 确认 GoLand 版本 ≥ 2023.2（Help → About 查 build number，低于
232.9559.62建议升级） - 确保项目根目录有合法
go.work（内容只列顶层模块路径，避免./module-a/internal这类子目录） - Settings → Go → Modules → 勾选
Enable Go workspaces support，取消勾选Auto-detect modules - 删掉
.idea/modules.xml和.idea/misc.xml，重启后让 IDE 重新按go.work构建 module 关系
清理构建缓存与模块缓存
索引慢常被误认为是“IDE 卡”，实则是 $GOCACHE 和 $GOMODCACHE 积累大量中间产物，导致文件监听和语义分析效率下降。清理必须分层执行，不能只清一个。
- 运行
go clean -cache清空$GOCACHE（默认 macOS 在~/Library/Caches/go-build），不影响模块缓存 - 运行
go clean -modcache清空$GOMODCACHE（默认$GOPATH/pkg/mod），注意需先确认GO111MODULE=on - 检查是否有进程正占用缓存：运行
lsof +D $(go env GOMODCACHE) | wc -l，输出非 0 则需杀掉 GoLand、终端里挂着的go run等进程再重试 - 若只想删某个出问题的模块（如校验失败），手动执行：
rm -rf $(go env GOMODCACHE)/github.com/xxx@v1.2.3和rm -rf $(go env GOMODCACHE)/cache/download/github.com/xxx
过滤补全干扰项以降低索引负载
GoLand 默认索引整张 go mod graph（含所有 // indirect 依赖），即使你从未 import 过，也会加载其符号——这直接增加索引体积和内存压力。
- 在项目根目录
.idea/misc.xml中添加：<option name="useImportPathsForIndexing" value="true"/>，强制只索引实际 import 的路径 - Settings → Editor → General → Auto Import → 取消勾选
Add unambiguous imports on the fly - 用 Scope 限制补全范围：新建 scope 如
main-only，模式填file:src//||file:cmd//||!file:**/vendor/**||!file:**/testutil/**，再在 Code Completion 设置中绑定该 scope - 执行
go mod tidy后，务必手动触发File → Reload project，否则旧索引仍在内存中
真正容易被忽略的是：vendor 排除和 go.work 启用必须同时生效，单做一项效果有限；而 go clean -modcache 后首次 go build 会重拉全部依赖，此时若 GOPROXY 未配国内镜像（如 https://goproxy.cn），下载过程本身就会卡住索引线程——别等它自己恢复，得主动干预环境变量。
