GoLand不自带Go运行时，必须先安装Go SDK并手动配置GOROOT指向根目录（如/usr/local/go或C:\Go），确保含src/pkg/bin三目录，且go version和dlv version在终端可用，再重启IDE生效。
GoLand 本身不带 Go 运行时，下载安装包只是第一步；真正卡住新手的，是 go 命令在终端里报错、IDE 里 Run 按钮灰色、调试断点不命中——这些问题全指向同一个根源：Go SDK 没装好，或没被 GoLand 正确识别。
go version 命令失败，GoLand 就没法工作
GoLand 不捆绑 Go 编译器，它只负责调用系统 PATH 下的 go 可执行文件。如果终端输入 go version 提示 command not found，GoLand 必然无法解析语法、无法构建、无法调试。
- Windows 用户务必下载官方
.msi安装包（不是 .zip），安装时勾选 Add Go to PATH - macOS 推荐用
brew install go，自动写入 PATH，无需手动处理 - Linux 用户解压二进制包后，必须把
bin/目录加进$PATH，例如：export PATH=$PATH:/opt/go/bin，并写入~/.bashrc或~/.zshrc - 装完立刻关掉所有终端窗口再重开，否则 PATH 不生效
GoLand 启动后必须手动关联 Go SDK
即使 go version 能跑，GoLand 也不一定自动找到它。首次新建项目或打开旧项目时，IDE 很可能显示 “No SDK configured”，此时不能跳过。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入
File → Settings → Go → GOROOT（Windows/macOS）或GoLand → Preferences → Go → GOROOT（macOS 菜单栏） - 点击右侧
...按钮，手动定位到 Go 安装目录下的bin上一级（如D:\Soft\Go或/usr/local/go），不是选bin/go文件本身 - 确认后点击
OK，等待几秒让 IDE 扫描 SDK 内置包路径 - 若项目已有
go.mod，GoLand 会自动启用模块模式，GOPATH设置基本可忽略
Run 按钮灰色？检查 main.go 位置和模块支持
GoLand 不会为任意 .go 文件生成运行配置。它只认两种合法入口：文件名是 main.go，且内容含 func main()；或者该文件属于一个已启用模块支持的项目。
- 新建项目时，务必勾选
Add Go module support，否则不会生成go.mod，后续依赖管理、代码跳转都会异常 - 如果
main.go在子目录（如cmd/myapp/main.go），需手动添加 Run Configuration：点击右上角Add Configuration → Go Build，Target 设为对应目录路径 - 刚建完
main.go就点 Run？等 3–5 秒，或手动触发File → Reload project，IDE 需要时间索引文件 - 文件名不是
main.go但写了func main()？右键该文件 →Run 'xxx.go'即可临时运行
dlv 调试失败，90% 是没装 Delve 或 PATH 没配对
GoLand 调试底层依赖 dlv，它不随 Go 或 GoLand 自动安装。首次点击 Debug 按钮时，IDE 会提示是否自动下载，但国内网络常失败。
- 手动安装命令：
go install github.com/go-delve/delve/cmd/dlv@latest - 装完后运行
dlv version，若报错command not found，说明$(go env GOPATH)/bin不在系统 PATH 中 - 补救方法：执行
echo $(go env GOPATH)/bin查出路径，然后把它加进 shell 配置文件（如~/.zshrc），再source ~/.zshrc - 重启 GoLand，Debug 按钮才能真正可用；断点命中前，确保源码和编译产物未被优化（
go build -gcflags="all=-N -l"可用于调试）
最易被忽略的一点：GoLand 的 GOPATH 设置界面只是个摆设，它几乎不影响现代模块化项目的实际行为；真正起作用的是项目根目录是否存在 go.mod，以及你的终端能否正常运行 go 和 dlv —— 所有配置都该以这两个命令在 shell 中可用为最终验证标准。
