goland环境搭建关键在于goroot、gopath与模块模式协同：goroot必须指向含bin/go的安装根目录（如/usr/local/go），gopath在go 1.16+后已退居次要，硬配错误易致cannot find package；新建项目应选“go module”而非勾选“add to gopath”，并用go env -w配置goproxy确保代理生效。
GoLand 环境搭建不是“装完就跑”，关键在 GOROOT、GOPATH 和模块模式的协同——用 Go 1.16+ 默认开启的 go mod，GOPATH 实际已退居次要，硬配错反而引发 cannot find package 或 go list failed。
确认本地 Go 版本并验证 GOROOT
GoLand 不会自动识别你系统里多个 Go 版本中的“正确那个”。它依赖系统 PATH 或手动指定的 GOROOT，而这个路径必须指向包含 bin/go 的完整安装目录（比如 /usr/local/go 或 C:\Go）。
- 终端运行
go version和go env GOROOT，记下输出值 - 在 GoLand 中：Settings → Go → GOROOT → 点击 folder 图标，粘贴上面查到的路径（不要选到
bin子目录） - 如果用
asdf或gvm管理多版本，务必用asdf current golang确认当前 shell 使用的版本，再把对应GOROOT填进 GoLand - 填错常见表现：新建项目时提示 “No SDK configured”，或运行
go build报command not found: go
初始化项目时别手动设 GOPATH
GoLand 创建新项目时默认勾选 “Add to GOPATH”，但 Go 1.13 起模块模式（go mod）已是事实标准。强行启用 GOPATH 模式会导致 go.mod 被忽略、依赖无法解析，甚至 go run main.go 直接失败。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 新建项目 → 选 “Go module” → 填写 module name（如
example.com/hello），不勾选 “Add to GOPATH” - 已有代码没
go.mod？终端进项目根目录，执行go mod init example.com/hello，GoLand 会自动识别 - 若误启 GOPATH 模式，Settings → Go → GOPATH → 清空路径，再重启项目
- 旧项目迁移注意：
vendor/目录和GOPATH/src/下的代码在模块模式下不再被自动扫描
代理与私有仓库配置常卡在 go env -w 权限上
国内用户绕不开 GOPROXY，但 GoLand 不读取 shell 的 .zshrc 或 .bash_profile，它只认 go env 输出的持久化设置。直接改环境变量文件无效，必须用 go env -w 写入。
- 终端执行：
go env -w GOPROXY=https://proxy.golang.org,direct（或国内镜像如https://goproxy.cn） - 私有 Git 仓库需加
git config --global url."ssh://git@xxx.com:".insteadOf "https://xxx.com/"，否则go get会卡在 HTTPS 认证 - GoLand Terminal 默认是 login shell，但 Terminal 面板右上角齿轮里要关掉 “Shell integration”，否则某些代理配置不生效
- 改完后重启 GoLand，用
go env GOPROXY验证是否写入成功
真正麻烦的不是步骤多，而是 GoLand 会缓存旧的 SDK 配置、模块索引和 vendor 状态；一旦出问题，别急着重装，先删 $USER_HOME/.GoLand*/system/caches/ 和项目下的 .idea/，再重新 open project。
