GoLand不自带Go运行时，必须独立安装go并手动配置GOROOT指向根目录（如/usr/local/go或C:\Go），确保PATH含$GOROOT/bin且IDE Terminal中which go与go version输出一致，否则新建项目、依赖下载、调试均失败。
GoLand 本身不带 Go 运行时，go 命令必须独立安装、路径正确、且被 IDE 显式识别，否则新建项目、依赖下载、调试全部失败——这是 90% 新手卡住的起点。
go version 显示旧版或报错，说明环境变量没走对
终端里 go version 正常，但 GoLand 内置 Terminal 或 Run Configuration 里执行失败/显示旧版本，本质是 IDE 没加载你改过的 shell 环境。
-
GOROOT必须指向 Go 安装根目录（如/usr/local/go或C:\Go），不是bin子目录 -
PATH中必须包含$GOROOT/bin，且不能被其他旧版go路径（比如/usr/bin/go）前置覆盖 - macOS Catalina+ 默认用
zsh，改了~/.bash_profile却没改~/.zshrc，source也无效 - Windows 上 MSI 安装勾选了 “Add to PATH”，但未重启 GoLand —— IDE 启动时只读一次系统环境变量
- 验证方式：在 GoLand 的 Terminal 里执行
which go和go version，输出必须和系统终端一致
GoLand 设置 GOROOT 失败，常见于路径误填或版本管理器干扰
GoLand 不从 PATH 自动探测 go，必须手动指定 GOROOT；填错路径或用了软链（如 goenv、g 管理的多版本）会导致 SDK 识别失败。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Linux/macOS：设置路径为
/usr/local/go（官方 tar.gz 解压默认位置）或/usr/local/opt/go/libexec（Homebrew 安装路径） - Windows：设为
C:\Go，确认该目录下有src、pkg、bin三个文件夹 - 用
goenv或g管理多版本时，GoLand 无法解析软链，需解压对应版本到独立目录（如/opt/go1.22.5），再手动指定 - 设置入口：File → Settings → Go → GOROOT（Windows/Linux）或 GoLand → Preferences → Go → GOROOT（macOS）
新建项目后依赖标红、go mod download 失败
IDE 插件默认不继承终端的 GOPROXY 和 GO111MODULE，即使你在 shell 里能 go get 成功，编辑器仍会报 cannot find package。
- 确保项目根目录存在有效的
go.mod文件（非空，首行是module example.com/xxx） - GoLand 设置：Settings → Go → Go Modules → 勾选
Enable Go modules integration，并显式填写GOPROXY（推荐https://goproxy.cn,direct） - VS Code 用户注意：
go.toolsEnvVars配置里必须显式加"GOPROXY": "https://goproxy.cn,direct" - 删掉残留的
go.work文件——它会强制启用多模块工作区，干扰单模块项目初始化 - 若初始化卡住，直接在 Terminal 执行
go mod init example.com/myapp，再右键项目 →Reload project
运行或调试 main.go 时提示 “no Go files in current directory”
这不是代码问题，而是 GoLand 的 Working directory 默认设为项目根目录，而你的 main.go 可能在子目录（如 cmd/app/main.go），导致 go run 在错误路径下执行。
- 编辑 Run Configuration →
Working directory改为$FileDir$（即当前文件所在目录） - 更稳妥的做法：Program arguments 填
./cmd/app，Working directory 保持项目根，用go run ./cmd/app显式指定包路径 - 避免用
go run main.go—— 它绕过 module 解析，不处理 import 路径，仅适合极简测试 - 调试时 Run kind 必须选
Package，Package path 填./或具体路径（如./cmd/app），填main.go文件路径会启动失败
真正容易被忽略的是：GoLand 的 GOROOT 和终端的 go 可能指向不同版本，而 IDE 不报错只静默降级使用——务必用 which go 和 go version 在 IDE Terminal 里双重验证。
