goroot必须指向go安装目录（如d:\go），只读不可改；gopath需设为独立项目目录（如d:\gofiles），自动生成src/pkg/bin，二者严禁混用，否则go install会污染安装路径。
GoLand 里 GOROOT 和 GOPATH 必须分开配，不能混用
GOROOT 指向 Go 安装目录（比如 D:\Go 或 /usr/local/go），只读、不可改；GOPATH 是你放项目的目录（比如 D:\GoFiles），它下面会自动生成 src、pkg、bin 三个子目录。常见错误是把 GOPATH 设成和 GOROOT 一样，结果 go install 把二进制写进 Go 安装目录，下次升级直接覆盖或权限报错。
实操建议：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Windows 用户：在系统环境变量中分别新建
GOROOT（值为 Go 解压/安装路径）和GOPATH（值为你自建的项目根目录，如D:\GoFiles） - 确保
Path中包含%GOROOT%\bin和%GOPATH%\bin，缺一不可 - Goland 启动后，进
File → Settings → Go → GOROOT手动选中路径，别依赖“自动检测”——它常为空
IDE 内置终端和调试器用的不是同一套环境变量
你在 Goland 里点运行或调试，背后启动的是独立进程，它不继承你 shell 里 source ~/.zshrc 或 Windows 的 CMD 环境变量快照。最典型表现：终端里 go env GOPATH 输出正确，但 Debug 控制台里却是空的，或者 go run 报 cannot find module for path。
实操建议：
- 调试前，务必打开 Goland 底部的
Debug Console，手动执行go env确认当前上下文的变量值 - 如果发现
GOROOT为空，回到Settings → Go → GOROOT重新指定，不要指望 IDE 自动识别 - 不想每次手动设？在项目根目录加
.env文件（Goland 支持读取），写入：GOROOT=D:\Go GOPATH=D:\GoFiles
多版本 Go 共存时，Goland 只能绑定一个 GOROOT，但可切换
Goland 不支持“运行时动态切 Go 版本”，每个项目只能固定用一个 GOROOT。但你可以为不同项目配置不同版本：比如项目 A 用 go1.21，项目 B 用 go1.23，只要它们的安装路径不同（如 D:\go1.21 和 D:\go1.23），就能分别在各自项目 Settings 里指定。
实操建议：
- 下载多个 Go 版本 zip 包，解压到不同路径（避免用 MSI 安装器，它会强行改系统 PATH 和注册表）
- 每个项目首次打开时，在
Settings → Go → GOROOT里选对应版本路径 - 别在全局设置里硬编码
GOROOT，否则新项目会继承旧值，容易错配 - 验证是否生效：在项目里新建
main.go，写fmt.Println(runtime.Version())，运行看输出
GO111MODULE 和 GOPROXY 必须显式配，尤其在国内
默认情况下，Go 1.16+ 启用模块模式，但 Goland 新建项目时可能仍走 GOPATH 模式，导致 go get 失败或依赖拉不下来。错误现象包括：go: cannot find main module、module lookup disabled by -mod=readonly。
实操建议：
- 在 Goland 的
Settings → Go → Go Modules页面，勾选Enable Go modules integration - 在
Environment variables区域添加：GO111MODULE=on和GOPROXY=https://goproxy.cn,direct - 如果项目已有
go.mod，右键点击它 →Reload project，强制刷新模块状态 - 命令行验证：在项目根目录执行
go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct，避免 IDE 配置遗漏
go env 输出——那才是你代码实际运行时看到的环境。
