goland项目级环境变量必须在run configuration中单独配置，因preferences→go environment仅影响ide解析（如补全、sdk识别），不传递给go build/run进程，导致goroot未生效而报错。
GoLand 项目级环境变量必须在 Run Configuration 里单独配，全局设置只影响 IDE 自身启动环境，不传递给 go build/run 进程。
为什么在 Preferences → Go Environment 里设了 GOROOT 还是报错
Preferences → Go → Go Environment 设置的是 GOROOT 和 GOPATH 的 IDE 解析路径，仅用于代码补全、SDK 识别和项目结构解析。它不会注入到你运行或调试时的子进程环境里。常见现象包括：
-
go run main.go报cannot find package "fmt"（实际是GOROOT没传给 go 命令） - 调试器启动失败，提示
failed to launch process: fork/exec ... no such file or directory - IDE 内置终端能
go version，但 Run 配置点一下就失败
根本原因：GoLand 启动 go 命令时，默认用的是系统 PATH 中的 go，而它依赖的 GOROOT 是由当前 shell 环境决定的——不是 Preferences 里填的那个。
Run Configuration 中如何正确添加环境变量
真正影响 go run、go test 或调试器行为的，是每个 Run Configuration 的环境变量字段。操作路径：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 点击右上角「Add Configuration」→ 「Edit Configurations…」
- 选中你的配置（如
go build或Directory类型） - 展开
Environment variables区域，点右侧…按钮 - 添加键值对，例如：
GOROOT=D:\golang、GO111MODULE=on、GOPROXY=https://goproxy.cn,direct
注意：GOROOT 必须指向真实安装目录（不含 \bin），且 Windows 下不要加尾部反斜杠；GO111MODULE 强烈建议设为 on，避免模块自动降级导致依赖解析异常。
调试时环境变量不生效的典型陷阱
即使 Run Configuration 配好了，调试器仍可能读不到——因为 Goland 调试器默认使用 dlv 启动，而 dlv 的环境继承逻辑和普通 go run 不同：
- 确保
dlv版本与 Go SDK 兼容（go env GOPATH下的bin/dlv或全局dlv） - 在 Debug 控制台手动执行
go env，确认输出的GOROOT和GO111MODULE是你期望的值 - 如果用了自定义
dlv路径（比如通过Go → Go Tools → dlv path设置），它可能绕过 Run Configuration 的环境变量 - Windows 上若用 WSL2 作为目标环境，Run Configuration 的环境变量不会自动同步过去，需在 WSL 内单独配置
避免重复配置的实用建议
频繁切换项目时，每个 Run Configuration 都手动填环境变量太累。更可持续的做法是：
- 把
GOROOT、GO111MODULE、GOPROXY等稳定项写进系统/用户环境变量（Windows：系统属性 → 环境变量；macOS/Linux：shell 配置文件），让所有终端和 IDE 子进程统一继承 - 只在 Run Configuration 里覆盖项目特有变量，比如
CONFIG_ENV=staging、DB_URL=... - 用
.env文件配合第三方插件（如 EnvFile）加载，但注意：GoLand 原生不支持.env自动注入，必须显式勾选启用
最常被忽略的一点：Goland 的「Terminal」和「Run」用的是两套环境继承路径——前者继承 shell，后者只认 Run Configuration。别指望在 Terminal 里 export GOROOT=... 后，点绿色三角就能生效。
