GOROOT未正确设置或Go模块未启用是GoLand功能异常的主因；需手动指定GOROOT路径并启用Go Modules，否则代码高亮、调试、依赖解析等功能均失效。
GoLand 启动后代码没高亮、go run 按钮灰掉、import 包标红——八成是 GOROOT 没设对，不是插件问题，也不是网络问题。
GOROOT 必须手动指定，且不能选错目录
GoLand 不会自动识别系统里装的 Go，哪怕你终端里 go version 能正常输出。常见错误是把 GOPATH（比如 ~/go）当成 GOROOT 去填，结果 IDE 根本加载不了标准库。
- 正确路径：macOS/Linux 是
/usr/local/go，Windows 是C:\Go；用asdf或gvm管理多版本时，必须填which go输出路径的父目录，比如/Users/xxx/.asdf/installs/golang/1.26.0/go，不能填软链接本身 - 设置位置：
Settings > Go > GOROOT→ 点右侧文件夹图标选择目录 → 点OK - 改完必须重启项目（不是重启 IDE），否则不生效；右下角状态栏看到
Go SDK: 1.26.0才算成功
go mod init 失败或依赖解析失败，本质是模块模式没开
新建项目后 go list -m all 报 not in a module，或者右键菜单里没有 Go Modules > Download modules，说明 GoLand 还在“传统 GOPATH 模式”下运行。
- 先确保项目根目录有
go.mod：终端进项目目录，执行go mod init example.com/myapp（包名不用真实域名，但别写main） - 勾选
Settings > Go > Go Modules > Enable Go modules integration，这是开关，不勾就等于关着模块感知 - 代理别漏
direct：在同一个设置页填GOPROXY，推荐https://goproxy.cn,direct；删过go.sum后，别直接点 IDE 的Sync，先终端跑go mod tidy，再让 IDE reload
断点不命中、dlv 启动卡住，大概率是调试器根本没装或版本不匹配
点击 Debug 后一直显示 Starting debug session...，或者报 could not launch process: fork/exec /path/to/dlv: no such file or directory，这不是配置问题，是 dlv 二进制压根不存在。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先查有没有：
which dlv，没输出就装：go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 必须用@latest，go get已废弃） - 确认运行配置里的
Working directory是模块根目录（含go.mod），否则dlv找不到main包 - Windows + WSL2 双环境用户注意：GoLand 在 Windows 上运行，但 Go 和
dlv装在 WSL 里——跨子系统路径无法调用，要么全切到 WSL 用 VS Code，要么在 Windows 原生重装 Go +dlv
第三方包跳转失效、补全不准，其实是依赖树没被正确索引
不是缓存坏了，也不是插件冲突，而是 GoLand 没拿到完整的模块依赖图。典型现象：能跳转 fmt.Println，但点不开 github.com/gin-gonic/gin 里的函数。
- 先确认
go mod download已执行完毕，vendor目录（如果存在）不要被标记为Excluded，否则 IDE 会跳过扫描 - 检查
Settings > Go > Go Modules里是否勾了Index vendor directories（默认不勾，要手动开） - 大型项目可配合
Help > Edit Custom VM Options加内存参数（如-Xmx4096m），否则索引中途可能被 GC 杀掉
最常被忽略的是：GOROOT 和模块模式这两个开关，只要一个没对，后面所有功能都会降级成“半残状态”。尤其 GOROOT 填错后，IDE 连 net/http 都认不出来，这时候调 proxy、换插件全是白忙。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
