goland本身不带go运行时，必须先安装系统级go工具链并正确配置goroot，否则新建项目卡在“no sdk configured”、go mod init报错、dlv调试失败；需终端验证go version，手动在settings→go→goroot中指定含src/pkg/bin的根目录（如macos填/opt/homebrew/cellar/go/1.22.3/libexec，windows填c:\program files\go），并设置go111module=on和goproxy=https://goproxy.cn,direct。
GoLand 本身不带 Go 运行时，必须先装好系统级 go 命令行工具链，再让 GoLand 指向它——否则新建项目卡在 “No SDK configured”，go mod init 报错，调试器启动失败，全是连锁反应。
验证本地 go 是否真可用
别信安装程序“完成”弹窗，终端里敲 go version 才算数。返回类似 go version go1.22.3 darwin/arm64 才表示路径和二进制都正常。
- Windows 用户如果报
'go' is not recognized，大概率是安装时没勾选 “Add Go to PATH”，得手动把C:\Program Files\Go\bin加进系统环境变量PATH - macOS 用 Homebrew 装的，路径通常是
/opt/homebrew/Cellar/go/1.22.3/libexec，不是/usr/local/bin/go—— 后者只是软链接，GoLand 要的是GOROOT（即含src/pkg/bin的根目录） - Linux 用户解压安装后，务必运行
sudo ln -s /path/to/go/bin/go /usr/local/bin/go并确认which go输出一致
GoLand 中正确设置 GOROOT
打开 GoLand → File → Settings → Go → GOROOT，点 + 添加路径，目标必须是 Go 安装根目录，不是 bin 子目录，更不是你放项目的 GOPATH。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- macOS（Homebrew）：填
/opt/homebrew/Cellar/go/1.22.3/libexec（进该目录能看见src文件夹） - Windows：填
C:\Program Files\Go（不是C:\Program Files\Go\bin） - Linux（tar.gz 解压）：填你解压到的完整路径，如
/usr/local/go - 选错路径的典型表现：
go run main.go在 IDE 内失败，但终端成功；或新建项目后fmt包标红、无法跳转到源码
go mod 初始化失败？检查模块开关与代理
新建项目点 “Go Module” 后控制台卡住、提示 cannot find module providing package fmt，基本是模块未启用或代理不通。
- 先终端执行
go env -w GO111MODULE=on（Go 1.16+ 默认开，但某些 Docker 镜像或旧安装会关） - 国内用户必设代理：
go env -w GOPROXY=https://goproxy.cn,direct（注意末尾,direct不能丢，否则私有仓库访问失败） - GoLand 设置里也要同步：Settings → Go → GOPROXY 填同样地址，否则 IDE 内部依赖解析仍走默认代理
- 验证是否生效：项目根目录下跑
go mod init example.com/hello && go mod tidy，看到下载日志且无红色错误才算通
调试器 dlv 启动失败的常见原因
点行号设断点 → 右键 Debug，弹出 Failed to start dlv 或 dlv: command not found，不是 GoLand 问题，而是 dlv 没装或版本不匹配。
- GoLand 第一次打开项目时会提示 “Some tools are missing”，点
Install即可自动装dlv、gopls等——但前提是go命令可用且网络通畅 - 手动装更可控：
go install github.com/go-delve/delve/cmd/dlv@latest，装完检查dlv version - 注意版本兼容性：
dlvv1.22.x 要求 Go ≥ 1.21；若用 Go 1.22.3，就别装太老的dlvv1.20 - Mac M 系列用户若遇到
incompatible architecture，需确认dlv是 arm64 编译的（file $(which dlv)查看）
最容易被忽略的是：GoLand 的 GOROOT 设置和终端里的 go 命令，背后必须指向同一套 Go 工具链。混用不同版本（比如终端用 1.22.3，IDE 指向 1.21.0），go mod 行为、gopls 语义分析、甚至 dlv 调试都会出不可预测的问题。
