goland运行配置中environment variables不继承系统变量，需手动勾选“include system environment variables”并正确设置path、goproxy等变量，否则导致exec not found或文件路径错误。
GoLand运行配置中Environment variables不继承系统变量
GoLand默认不自动加载系统环境变量（比如HOME、USER、GOPROXY），即使你在终端里go env能正常显示，IDE内部调试器或构建流程仍可能读不到。常见表现是exec: "jq": executable file not found in $PATH，或open config.yaml: no such file——本质是PATH或HOME缺失导致路径解析失败。
解决办法不是“关掉IDE重开”，而是显式勾选继承选项：
- 打开
Run → Edit Configurations…，选中你的Go Build配置 - 在
Environment variables右侧点…，填完自定义变量后，务必勾选Include system environment variables - 若依赖外部CLI（如
curl、git、protoc），建议在Environment variables里补全PATH：例如PATH=/usr/local/bin:/opt/homebrew/bin:$PATH（macOS）或PATH=C:\Windows\System32;C:\Program Files\Git\cmd;%PATH%（Windows）
传参时Program arguments和Environment variables的分工要清楚
Program arguments只负责命令行参数（即os.Args[1:]），而Environment variables影响整个进程环境（包括子进程、os.Getenv()、log.SetOutput()等）。混淆二者会导致参数被忽略或解析异常。
典型错误场景：
- 把
--env=prod写进Environment variables→ 程序收不到，因为没对应os.Args项 - 把
LOG_LEVEL=debug写进Program arguments→ 启动直接报错unknown flag - 用
GO_ENV=staging替代--env=staging，但代码里只检查os.Args→ 白配
正确做法：Program arguments填--port=8081 --config=./config/dev.yaml；Environment variables填LOG_LEVEL=debug GOPROXY=https://goproxy.cn,direct。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
Working directory设错会导致相对路径全部失效
GoLand默认以项目根目录为Working directory，但多数Go服务会用./config.yaml或../migrations这类相对路径加载资源。一旦工作目录不对，os.Open("./config.yaml")就直接panic。
设置建议：
- 如果
main.go在./cmd/api，且config.yaml也在该目录下，Working directory应填$ProjectFileDir$/cmd/api（推荐绝对路径） - 如果频繁切换不同
main.go（如./cmd/cli和./cmd/api），可用$FileDir$动态取当前文件所在目录 - 千万别留空——留空 = 项目根目录，90%的
no such file错误源于此
GOROOT和GOPATH在GoLand里通常不需要手动填
GoLand 2021.3+ 默认启用自动SDK检测，会扫描$PATH找go命令并推导GOROOT。手动在Settings → Go → GOROOT里填路径，反而容易覆盖真实路径（比如指向源码目录或旧版本），导致gopls启动失败或go mod download报cannot find module。
真正需要干预的只有两种情况：
- 机器上装了多个Go版本，且项目必须锁定某版（如CI用1.21，本地开发用1.23）→ 此时在
Run Configuration里用GOROOT环境变量覆盖，而非全局设置 - Go安装在非标准路径（如
/opt/go-custom），且$PATH未包含/opt/go-custom/bin→ 此时才需在Settings → Go → GOROOT中指定
至于GOPATH，Go 1.16+模块模式下它只控制go install输出位置（$GOPATH/bin）和缓存（$GOPATH/pkg），不影响源码导入。除非你还在用src/老结构，否则别碰它。
