GoLand不会自动识别系统Go SDK，必须手动配置GOROOT（如C:\Go或/usr/local/go），否则无法创建项目；需启用Go Modules、设置GOPROXY代理，并安装gopls与dlv工具以支持补全、跳转和调试。
GoLand 不会自动识别系统已安装的 Go，装完不配 GOROOT 就写不了代码——这是最常卡住新手的第一步。
GoLand 找不到 Go SDK：必须手动设 GOROOT
它不会读取系统 PATH 或依赖 go version 的结果，而是完全靠你手动指定路径。Auto-detect 在多版本共存时大概率选错，别信。
- 打开
Settings > Go > GOROOT，点击+，直接浏览到 Go 安装根目录（Windows 是C:\Go，macOS 是/usr/local/go，Linux 同 macOS） - 终端运行
go env GOROOT，输出的就是你要填的路径，复制粘贴最稳 - 如果填错，新建项目时会直接报错
Cannot find SDK，且无法创建main.go
新建 Go Module 项目失败：路径和模块代理双坑
点 New Project > Go > Go Module 后空白或提示 cannot find module providing package，基本不是 IDE 崩了，而是环境没对齐。
- 项目路径不能含中文、空格、特殊符号（比如
~/Desktop/我的项目→ 改成~/go/src/hello） -
Settings > Go > Modules中必须勾选Enable Go modules integration - 代理必须设为可用源：
GOPROXY=https://goproxy.cn,direct（国内）或https://proxy.golang.org,direct（海外），direct不能删，否则私有模块会拉不到 - 改完代理后，终端执行
go env -w GOPROXY="https://goproxy.cn,direct"，再重启 GoLand，避免 IDE 缓存旧配置
代码不补全、跳转失效：gopls 没装或不在 PATH
GoLand 的语义分析、函数跳转、类型推导全靠 gopls，它不是 Go 自带，也**不**随 GoLand 自动安装。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
立即学习“go语言免费学习笔记（深入）”；
- 终端运行
go install golang.org/x/tools/gopls@latest（注意是@latest，不是@stable） - 执行完后，终端输
gopls version，能输出版本号才算成功 - 确认
GOBIN在系统 PATH 里：运行go env GOBIN，把输出路径加进系统环境变量（Windows 是系统变量 PATH，macOS/Linux 是~/.zshrc或~/.bash_profile） - GoLand 设置里不用填
gopls路径，只要它能在终端直接执行，IDE 就会自动发现
断点不生效、调试器启动失败：Delve 版本与 Go 不匹配
报错 could not launch process: fork/exec /path/to/dlv: no such file or directory，说明 dlv 根本没装；报错 version mismatch，说明版本太旧或太新。
- 终端运行
go install github.com/go-delve/delve/cmd/dlv@latest - 验证：
dlv version输出中Version:行要和当前 Go 版本兼容（Go 1.22+ 推荐用 dlv v1.23+） - GoLand 默认调用系统 PATH 中的
dlv，不需要在设置里指定路径；但如果装了多个版本，确保which dlv指向的是最新版 - 调试前右键项目根目录 →
Reload project，否则 IDE 可能仍用旧缓存
真正容易被忽略的是：所有路径（GOROOT、项目路径、GOBIN）必须全英文，且一旦配置完成就不要移动文件夹——移动后 gopls 和 dlv 的缓存索引会断，IDE 往往不报错，只是功能静默失效。
