GoLand安装后必须手动配置GOROOT、GOBIN和模块代理。需指定GOROOT路径、确保GOBIN在PATH中、启用Go modules并设置goproxy，安装并配置gopls和dlv，避免中文路径与环境变量冲突。
GoLand 安装后必须做的三件事
GoLand 不是开箱即用的 Go IDE，装完不配置 GOROOT 和 GOBIN 就写不了代码。它不会自动识别系统已安装的 Go，也不会帮你设好模块代理或调试器路径。
- 打开 Settings > Go > GOROOT，手动指向你的 Go 安装目录（例如
/usr/local/go或C:\Go），不要依赖“Auto-detect”——它在多版本共存时大概率选错 - 确认
GOBIN已加入系统PATH：运行go install golang.org/x/tools/gopls@latest后，gopls必须能在终端里直接执行，否则 GoLand 的语义分析和跳转会失效 - 在 Settings > Go > Modules 中勾选
Enable Go modules integration，并设置Proxy为https://goproxy.cn（国内用户）或https://proxy.golang.org（海外），避免go get卡死
新建项目时 module 初始化失败的常见原因
点击 New Project > Go > Go Module 后提示 “cannot find module providing package” 或空白初始化，基本不是 IDE 问题，而是当前路径或环境变量冲突。
- 确保新建项目路径不含中文、空格或特殊符号（如
~/Desktop/我的项目→ 改为~/go/src/myapp） - 检查终端中
go env GOPATH输出是否与 GoLand 内部 GOPATH 一致；若不一致，在 Settings > Go > GOPATH 中显式填写，不要留空 - 如果项目根目录已有
go.mod但 GoLand 没加载，右键目录 →Reload project，而不是重启 IDE
调试器无法启动：dlv 版本与 Go 版本不匹配
dlv 不是 Go 自带组件，GoLand 默认尝试调用 dlv 命令，但未安装或版本过旧会导致断点无效、进程立即退出、甚至报错 could not launch process: fork/exec /path/to/dlv: no such file or directory。
- 先在终端运行
dlv version，确认已安装；若未安装，执行go install github.com/go-delve/delve/cmd/dlv@latest - Go 1.21+ 用户必须用 dlv 1.21+，否则调试器会静默失败；可运行
go list -m github.com/go-delve/delve查看兼容性 - 在 Run > Edit Configurations > Go Build 中，把
Debugger设为Delve，并确认Path to dlv指向你刚安装的二进制（如$GOPATH/bin/dlv）
代码补全/跳转失效：gopls 配置被忽略
即使 gopls 已安装，GoLand 仍可能走旧的 go build 模式做索引，导致 Ctrl+Click 跳不到定义、Ctrl+Space 补全只有基础类型。
立即学习“go语言免费学习笔记（深入）”；
- 进入 Settings > Languages & Frameworks > Go > Go Language Server，勾选
Enable language server，且Path to gopls必须填绝对路径（不能是gopls） - 关闭
Use legacy go parser（该选项在 Settings > Editor > File Types 下，搜索 “Go” 可找到） - 如果项目含
//go:build条件编译，需在 Settings > Go > Build Tags 中填入对应 tag（如linux,amd64），否则 gopls 会跳过部分文件索引
package main
import "fmt"
func main() {
fmt.Println("Hello, GoLand")
}
模块代理、dlv 版本、gopls 路径——这三个点任意一个没对齐，IDE 就会退回“高级文本编辑器”状态。别信自动配置，每个都得亲手核对。
