GoLand 默认配置需调整模块管理、调试和依赖提示三方面：启用go mod、配置dlv调试器、设置国内代理源及vendor模式，否则易出现报红、断点失效和补全卡顿。
GoLand 装完就能写 Go，但默认配置离日常开发有明显距离——尤其模块管理、调试体验和依赖提示这三块，不调准容易卡顿、报红、断点失效。
GoLand 启动时提示 go mod 未启用或 GO111MODULE=auto 不生效
这是新项目最常卡住的第一步：GoLand 默认不强制开启模块模式，而当前主流 Go 项目（1.16+）已完全基于 go mod。如果项目根目录有 go.mod 却仍报 cannot find module providing package，大概率是 IDE 没读到正确的 Go 环境变量。
- 在
Settings > Go > GOPATH中，**不要**手动填路径；勾选Use GOPATH that is defined in system environment - 进
Settings > Go > Go Modules，确保Enable Go modules integration已勾选，且Go version设为与本地go version一致（如1.21） - 若用终端启动 GoLand（如
~/Library/Application Support/JetBrains/Toolbox/bin/goland.sh），它能继承 shell 的PATH和GO111MODULE；若从 Dock 或 Launchpad 启动，需在Help > Edit Custom Properties里加一行：idea.shell.path=/bin/zsh（换成你实际的 shell）
调试时断点不命中，或显示 unavailable / optimized out
GoLand 调试器底层依赖 dlv（Delve），但默认安装的 dlv 版本可能与 Go 版本不匹配，或编译时被优化干扰。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先运行
go install github.com/go-delve/delve/cmd/dlv@latest，确保dlv在$PATH中可执行 - 在
Run > Edit Configurations > Go Build中，取消勾选Build tags（除非你真用了构建标签）；在Go tool arguments里加-gcflags="all=-N -l"—— 这两个 flag 关闭内联和优化，是断点可用的前提 - 检查
Settings > Go > Debugger，确认Use native debugger未勾选（GoLand 2023.3+ 默认用原生调试器，但部分 macOS M 系列芯片仍有兼容问题，切回 Delve 更稳）
代码补全卡顿、go.sum 反复刷新、第三方包跳转失败
本质是 GoLand 的索引机制和 go list -json 扫描行为受模块代理、网络和 vendor 状态影响。不是 CPU 不够，而是它在等一个没响应的 proxy.golang.org 请求。
- 在
Settings > Go > Go Modules中，填入国内镜像源：https://goproxy.cn,direct（注意逗号分隔，direct是 fallback） - 关闭
Settings > Editor > General > Auto Import > Add unambiguous imports on the fly—— 这个功能在大型模块中会频繁触发go list，拖慢输入响应 - 如果项目用了
vendor，务必勾选Settings > Go > Go Modules > Vendoring mode，否则 IDE 会忽略vendor/目录，导致跳转指向缓存而非本地代码
真正麻烦的从来不是装软件，而是环境变量、代理链路、调试器版本、模块解析顺序这四者之间那几处隐性耦合——比如你在终端里 go run 没问题，但 GoLand 里跑不通，八成是 shell 启动方式或 GOROOT 路径没对齐。多看 Help > Show Log in Explorer 里最近的 go.mod 解析日志，比重装快得多。
