必须手动创建Go Build运行配置，否则默认“Go Build”模板不读Program arguments；常见失效原因是选错运行目标、Run kind未设为Directory、Working directory错误或漏调flag.Parse()。
GoLand里“Go Build”默认模板根本不读Program arguments
点绿色三角运行时参数没生效，八成是因为你还在用顶部下拉菜单里那个带灰色Default字样的Go Build模板。它每次都是空配置，不保存任何参数，也不解析os.Args。
必须手动新建一个运行配置，名字比如dev-server或cli-debug，然后确保顶部下拉菜单选中的是它，而不是Go Build。
- 新建路径：
Run → Edit Configurations… → + → Go Build - 填好
Package path（如./cmd/api）和Output directory（可留空） -
Run kind必须选Directory：选File会导致go.mod不加载、import失败，后续flag.Parse()也收不到参数
Program arguments怎么填才被main()真正读到
参数得靠flag.Parse()才能语义化，光有os.Args没用。漏掉这句，flag.String()等全失效，哪怕参数已传进进程也没意义。
- 直接在
Program arguments框里写，空格分隔，不用引号包裹整个字符串 - 值含空格时用单引号：
'--name=prod server'（Windows下双引号可能被shell吞掉） - 子命令结构要完整：
serve --port=3000 --config=config.yaml，不能只写--port=3000 - 别把参数塞进
Environment variables或Working directory——那些地方根本传不进os.Args
Working directory设错会让参数“存在但文件打不开”
很多CLI靠相对路径加载配置，比如ioutil.ReadFile("config.yaml")。Working directory错了，flag.Parse()成功了，但文件操作直接panic。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 推荐填
$FileDir$：自动指向当前main.go所在目录，适合多入口调试 - 项目结构固定时，填绝对路径更稳：
$ProjectFileDir$/cmd/api - 留空 = 项目根目录；90% 的
open config.yaml: no such file都源于此
改参数要不要重新编译？关键看Build before run
GoLand的调试和构建是解耦的。只要本地已有二进制（之前Run过 / 或启用了Build before run），改完Program arguments后直接点虫子图标就能生效。
- 想跳过编译只换参：取消勾选
Build before run（在配置页底部） - 取消后需确保当前有可用二进制，否则Debug报
cannot run program - 启用
Build before run时，每次都会调go build生成临时文件，但参数仍以Program arguments为准
最容易被忽略的是：Working directory和Run kind这两个配置项，它们不报错、不标红，但一旦设错，参数就“静默失效”。调试前务必肉眼确认这两项。
