goland启动需手动配置goroot，启用go modules，安装delve调试器，匹配go插件版本，并正确处理vendor、replace及代理设置。
GoLand 启动时提示 GOROOT 未设置或指向错误路径
GoLand 不会自动识别系统已安装的 Go，必须手动指定 GOROOT。常见现象是新建项目后 go mod init 失败、代码无语法高亮、go run 按钮灰掉。
- 打开 Settings > Go > GOROOT，点击右侧文件夹图标，选择你本地 Go 安装目录（如
/usr/local/go（macOS/Linux）或C:\Go（Windows）） - 别选错成
GOPATH目录（那是工作区，不是 Go 安装根目录） - 如果用
asdf或gvm管理多版本 Go，GOROOT必须指向当前 shell 中which go输出的二进制所在父目录，不是软链接本身 - 改完记得点 OK 并重启项目——GoLand 不会热重载
GOROOT
GoLand 里 go mod 命令不生效或依赖无法解析
不是 GoLand 的 bug，而是模块模式没被正确激活。典型表现：import 包标红、go list -m all 报错 not in a module、右键菜单里没有 Go Modules > Download modules。
- 确保项目根目录下有
go.mod文件；没有就终端执行go mod init example.com/myapp（包路径随便起，但不能是main） - GoLand 默认只在“Go Modules”模式下才启用模块感知——检查 Settings > Go > Go Modules 是否勾选了
Enable Go modules integration - 如果用了代理（比如 GOPROXY），在 Settings > Go > Go Modules 里填上
https://proxy.golang.org,direct，别漏掉,direct - 删掉
go.sum后不要直接点 “Sync”，先在终端跑go mod tidy，再让 GoLand 自动 reload
调试时断点不命中，或 dlv 启动失败
GoLand 调试依赖 dlv（Delve），但它不会自动安装，且版本和 Go 版本有兼容要求。现象包括：点击 Debug 按钮后卡在 “Starting debug session”，或报错 could not launch process: fork/exec /path/to/dlv: no such file or directory。
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） - GoLand 默认调用
dlv时加了--headless和--api-version=2，如果你装的是太老的 dlv（ - 调试前确认当前运行配置的
Working directory是模块根目录（含go.mod），否则 dlv 找不到 main 包 - Windows 用户注意：如果用 WSL2 开发，GoLand 运行在 Windows 上，但 Go 和 dlv 装在 WSL 里，这种跨子系统路径没法直接调用——要么全在 WSL 里用 VS Code，要么在 Windows 原生装 Go + dlv
GoLand 自动补全/跳转失效，特别是第三方包
这不是索引坏了，大概率是 GoLand 没正确识别模块依赖树。表现为：按 Ctrl+Click 跳不到第三方包源码，fmt. 后没列出函数，go list -f '{{.Dir}}' golang.org/x/net/http2 能查到路径，但 IDE 里就是不识别。
- 先检查 Settings > Go > Go Modules 里的
Index entire GOPATH是否关闭——开启它反而会让 GoLand 去扫旧 GOPATH 模式下的 vendor，干扰模块路径解析 - 执行
go mod vendor后，GoLand 默认不会自动切换到 vendor 模式；如需强制走 vendor，要在 Settings > Go > Go Modules 勾选Use vendor directory - 第三方包源码没索引？手动触发：右键项目根目录 → Reload project，或点右上角小齿轮 → Reload project from go.mod
- 如果用了 replace 指向本地路径（如
replace golang.org/x/net => ../net），确保那个本地路径是完整 Git 仓库（有.git目录），否则 GoLand 无法建立符号链接索引
最常被忽略的一点：GoLand 的 Go 插件版本必须和 Go SDK 版本匹配。比如用 Go 1.22，但插件还是旧版，就可能连 go.work 文件都识别不了。更新方式很简单：检查 Settings > Plugins 里 “Go” 插件是否为最新，不是就更新，然后重启 IDE。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
