必须手动创建go build运行配置：选择directory模式并指定main.go所在目录；在program arguments中传参，设置working directory为配置文件所在路径；通过environment variables添加goroot等变量并勾选继承系统环境；取消build after、勾选run after build和emulate terminal。
要在GoLand中让Go程序按需启动、传参调试、读取环境变量，必须手动创建并精细配置Go Build运行配置，否则点击右上角绿色三角只会报错或静默失败。
创建永久Go Build运行配置
打开 Run → Edit Configurations… → 点击左上角 + → 选择 Go Build。
在右侧填写名称（如 dev-server），该名称会出现在顶部运行下拉菜单中，建议与项目用途一致。
关键一步：在 Run kind 下拉框中选择 Directory —— 这是单模块项目最稳妥的方式，【不能选File，否则无法解析import路径和go.mod依赖】。
在 Directory 字段中点击右侧文件夹图标，精准定位到含 main.go 的目录（例如 ./cmd/api），不要选整个项目根目录，否则可能因多main包冲突报错。
注入启动参数与工作目录
在 Program arguments 栏中直接输入命令行参数，例如：--port=8081 --env=staging。参数间用空格分隔，无需引号包裹，除非值本身含空格（此时用单引号，如 '--name=prod server'）。
设置 Working directory：若程序依赖相对路径读取配置文件（如 ./config.yaml），必须将此项设为该文件所在目录；若留空，GoLand默认使用项目根目录，容易导致 open config.yaml: no such file 错误。
方法一（推荐）：填入绝对路径，如 $ProjectFileDir$/cmd/api；方法二（动态）：填入 $FileDir$，适用于频繁切换不同 main.go 文件调试的场景。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
添加环境变量
点击 Environment variables 右侧的 … 按钮，打开环境变量编辑窗口。
点击 Add（+号），逐行输入键值对：
GOROOT=/usr/local/go
GOPROXY=https://goproxy.cn,direct
LOG_LEVEL=debug
注意：GOLAND不会自动继承系统PATH，若依赖外部CLI工具（如jq、curl），必须显式补全PATH变量，否则exec: "jq": executable file not found in $PATH。
填完后勾选 Include system environment variables，确保基础环境（如HOME、USER）不丢失。
配置构建与执行行为
第一步：取消勾选 Build after 下的 Build 项 —— 若你已在终端手动执行过 go mod tidy 且依赖稳定，跳过IDE自动构建可提速3秒以上。
第二步：勾选 Run after build，确保编译成功后立即执行；同时勾选 Emulate terminal in output console，使日志输出格式与真实终端一致（支持ANSI颜色、换行控制）。
第三步：在 Go tool arguments 中填入 -ldflags="-s -w"，剥离调试符号并减小二进制体积，适合测试阶段快速验证。
最后点击 OK 保存配置，此时右上角运行按钮将激活，点击即可启动带参、带环境、带工作路径的Go进程。
