根本原因是GoLand默认JVM堆内存不足（仅512M–1G），而大型Go项目索引峰值常超3GB；应修改goland.vmoptions，配对设置-Xms2g -Xmx4g，添加-XX:MaxMetaspaceSize=512m和-XX:ReservedCodeCacheSize=512m，并确保排除vendor、启用go.work支持且彻底退出IDE重载参数。
GoLand 启动大型 Go 项目卡在 indexing 或直接报 java.lang.OutOfMemoryError: java heap space，根本原因不是项目本身有问题，而是 JVM 堆内存没给够——默认配置连 1GB 都不到，而一个带 vendor 和多模块的微服务工程，索引阶段峰值轻松突破 3GB。
怎么改 goland.vmoptions 才不翻车
Mac 上路径是 ~/Library/Caches/JetBrains/GoLand2023.3/goland64.vmoptions（版本号随安装变），Windows 是 %USERPROFILE%\AppData\Roaming\JetBrains\GoLand2023.3\goland64.vmoptions，Linux 在 ~/.config/JetBrains/GoLand2023.3/goland64.vmoptions。别手抖改错文件，否则白调。
- 删掉所有含
-XX:+UseG1GC的行——GoLand 官方明确不推荐手动指定 GC，G1 在 2–4GB 堆场景下反而增加停顿 -
-Xms和-Xmx要配对设：比如-Xms2g+-Xmx4g；-Xmx别超物理内存 50%，且不建议超过 6g（JVM 堆越大，GC 压力非线性上升） - 加一行
-XX:ReservedCodeCacheSize=512m，防止 JIT 编译退化拖慢索引速度 - 别碰
-XX:MaxDirectMemorySize，除非你明确用了 gRPC 插件等重度堆外内存工具；普通项目默认值足够
为什么设了 -Xmx4g 还会 OOM
常见错误是只调了最大堆，却忽略 JVM 其他内存区域。IDE 启动后实际占用 = 堆 + Metaspace + CodeCache + 直接内存，其中 Metaspace 默认无上限，加载大量 Go 类型和插件时可能吃掉额外 1–2GB。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 加上
-XX:MaxMetaspaceSize=512m，避免元空间无限膨胀 - 确认没开 Rosetta 2 模拟运行：M1/M2 Mac 上必须用原生 ARM64 版 GoLand，否则 JVM 内存映射异常，
-Xmx实际生效值可能被截断 - 启动后打开 Help → Diagnostic Tools → JVM Metrics，看 “Used Heap” 和 “Metaspace Used” 是否接近你设的上限——如果 Metaspace 已占 800MB，说明
-XX:MaxMetaspaceSize必须补上
go.work 多模块项目索引爆炸的内存诱因
GoLand 2023.2+ 支持 go.work，但旧版或配置错会导致 IDE 把每个 use 目录当独立 module 扫描，vendor 路径被反复解析，内存直接翻倍。
- 检查
go.work文件内容：别写use ./module-a ./module-a/internal，子目录会被重复加载 - Settings → Go → Modules 中必须勾选
Enable Go workspaces support，并**取消勾选**Auto-detect modules - 删掉项目下的
.idea/modules.xml和.idea/misc.xml，重启让 IDE 重建 module 关系 - vendor 目录必须在 Settings → Directories 中标记为
Excluded，否则每次保存 .go 文件都触发全量 vendor re-index
真正容易被忽略的是：改完 goland.vmoptions 后必须彻底退出 GoLand（macOS 上右键 Dock 图标选 Quit，不能只是关窗口），否则 JVM 参数不会重载。另外，-Xmx 设太高反而会让 GC 停顿更长，4GB 是多数 16GB 内存机器的甜点值——再大，不如先优化 go.work 结构和排除 vendor。
