GoLand项目级环境变量需在File→Settings→Go→Go Environment中配置,GO111MODULE、GOPROXY、GOBIN必须显式设置;Run Configuration和Terminal需分别启用继承,否则子进程无法读取。

GoLand 项目级环境变量在哪配
不是改系统 PATH,也不是在终端里 export,而是进 IDE 设置里绑定到当前项目:打开项目后,点击顶部菜单 File → Settings(Windows/Linux)或 GoLand → Preferences(macOS),左侧选 Go → Go Environment,在 Environment 字段右侧点 …,打开编辑窗口即可增删变量。
GO111MODULE、GOPROXY、GOBIN 这几个必须显式设
它们不继承系统值,也不靠 go env -w 生效——IDE 启动的调试器和运行进程默认读不到 shell 里的 go env 设置:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
GO111MODULE=on:避免报not in a module,尤其项目有go.mod却仍走 GOPATH 模式 -
GOPROXY=https://goproxy.cn,direct:防止私有模块拉取失败;direct是 fallback,不能漏 -
GOBIN=$GOPATH/bin或更安全的$PROJECT_DIR/out/bin:避免go install把二进制写进$GOROOT/bin,污染 SDK
Run Configuration 不会自动继承项目变量
项目级设置只影响 IDE 自身进程,子进程(即你跑的 go run 或调试器)默认不带这些变量。要让所有运行/调试配置生效,必须两步都做:
- 在 Settings → Go → Go Environment 中设好基础变量(如
GO111MODULE、GOPROXY) - 再进 Run → Edit Configurations → Templates → Go Build,勾选
Include system environment variables,并在下方Environment variables栏填业务变量(如APP_ENV=dev) - 已存在的配置需手动勾选
Use template settings,否则不会更新
Terminal 标签页默认不读项目变量
你在 GoLand 底部 Terminal 里敲 go env 看到的,是系统环境,不是项目级设置。想让它同步:
- 进 Settings → Tools → Terminal → Shell path
- 勾选
Activate environment variables from project configuration - Windows 用户改完系统变量后必须重启 GoLand;macOS/Linux 用户若从桌面图标启动,
.zshrc里的export不会被加载
os.Getenv 拿不到值」或「go list -m all 报错」这类问题。










