GoLand必须手动配置GOROOT、GOBIN和模块代理，否则新建项目失败、代码跳转失效、断点不触发；需指定GOROOT路径、确保GOBIN在PATH中、启用Go modules并设置goproxy，同时安装配置gopls和dlv。
GOROOT不手动填，新建项目直接失败
GoLand装完不能直接写代码，它不会自动识别你系统里装的 Go。尤其当你有多个版本（比如 go1.21 和 go1.22），Auto-detect 基本选错路径，导致新建项目空白、跳转失效、断点不触发。
必须打开 Settings > Go > GOROOT，手动填入真实路径：
- Linux/macOS 通常是
/usr/local/go，确认该路径下存在bin/go - Windows 是
C:\Go或你自定义的路径（如D:\tool\go） - 如果用 tar.gz 解压到家目录，路径要精确到
~/go这一级，不能只填~
填完后，在终端运行 go version 验证是否能正常输出版本号——这是最直接的校验方式。
GOBIN不在PATH里，gopls根本起不来
gopls 是 GoLand 语义分析、跳转、补全的核心语言服务器，它不是 IDE 自带的，而是靠 go install 安装到 GOBIN 目录。如果终端里都找不到 gopls，GoLand 就会降级为纯文本编辑器。
执行这两步：
- 先在终端运行：
go install golang.org/x/tools/gopls@latest - 再查安装位置：
which gopls（macOS/Linux）或where gopls（Windows） - 确保输出路径和
go env GOBIN一致；不一致就将该路径加进系统PATH，并重启 GoLand（不是仅重载项目）
检查 GoLand 底部状态栏右下角是否有 gopls 连接图标；没图标或显示 “not connected”，说明没生效。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
新建 Go Module 卡住？90% 是路径或代理问题
点击 New Project > Go Module 后空白、卡住，或报 cannot find module providing package，跟 IDE 本身无关，纯粹是路径或模块代理配置不到位。
立即检查以下三点：
- 项目路径不能含中文、空格、特殊符号（如
~/Desktop/我的项目→ 改成~/go/src/myapp） - Settings > Go > Modules 中必须勾选
Enable Go modules integration，且Proxy设为国内可用地址：https://goproxy.cn或https://mirrors.aliyun.com/goproxy/（末尾保留,direct） - 首次新建时模块名建议用完整路径格式，如
github.com/yourname/hello，避免只输hello
已有 go.mod 但 GoLand 没加载？不要重启 IDE，右键项目根目录 → Reload project 即可。
dlv 调试器静默退出，大概率是版本不匹配
断点设了但程序一闪而过、控制台无输出，甚至报 could not launch process: fork/exec /path/to/dlv: no such file or directory，基本就是 dlv 没装或版本不匹配。
调试器不是开箱即用的组件，必须显式安装：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest - 确认
dlv可执行文件落在GOBIN下，且与当前 Go 版本兼容（例如 Go 1.22 推荐用 dlv v1.22+） - GoLand 的调试配置里，
Debugger类型要选Delve，不是Legacy
注意：Go 1.21+ 默认启用 delve 的 --headless 模式，若本地防火墙拦截或 SELinux 启用，也可能导致静默失败——这种细节容易被忽略，但排查时值得快速扫一眼。
