GoLand中应使用永久运行配置替代临时配置，通过Run | Edit Configurations创建带环境变量、路径变量的命名配置（如api-dev），支持多项目复用、批量启停及团队共享。
GoLand 里反复切换项目、手动改 Directory 或 Output directory 启动配置，本质是没用对“永久配置 + 模板复用”机制。真正省时间的做法，是让每个项目/环境拥有独立、可复用、带参数的运行配置。
为什么临时配置不能满足多项目启动需求
每次点击边栏 Run 图标生成的都是临时配置，图标半透明，最多保留 5 个，旧的自动被删。它不保存 Working directory、Environment variables、Program arguments 等关键上下文，切项目就得重填——尤其当你要同时跑 api、worker、admin 三个子服务时，每换一个都得手动指定目录和环境变量，极易出错。
- 临时配置不会记住你上次在
dev环境下跑了APP_ENV=dev，下次点运行就回到空环境 - 无法批量启用/禁用某组配置（比如测试时关掉所有
worker相关配置） - 团队共享困难：临时配置不存入项目，别人拉代码后还得自己配一遍
创建带环境变量的永久 Go Build 配置
核心是把启动逻辑固化为命名配置，而非依赖编辑器自动推断。适用于需要区分 dev/staging/prod 或不同服务入口的场景。
- 打开
Run | Edit Configurations...（或按Alt+Shift+F10→0） - 点击
+→ 选择Go Build -
Name填具体含义，如api-dev、worker-staging，别用默认的go build -
Run kind选Directory，Directory填对应服务根目录（如$ProjectFileDir$/services/api） -
Environment variables里加APP_ENV=dev、LOG_LEVEL=debug等，多个用分号隔开 - 勾选
Include modules from external libraries（避免因 vendor 或 replace 导致构建失败）
配置保存后，它会出现在顶部运行配置切换器中，图标不透明，可随时调用。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
用 Go Test 配置替代 go test ./... 手动执行
跑单测时如果总在终端敲 go test -race ./... 或 go test -coverprofile=... ./...，说明没利用好 GoLand 的测试配置模板。
- 新建配置时选
Go Test，不是Go Build -
Test kind选Package，Package填具体路径（如./services/api/handler），避免全量扫描 -
Program arguments填-race -count=1，-count=1防止缓存干扰结果 - 需要覆盖率时，在
Go tool arguments里加-coverprofile=coverage.out，后续可一键生成 HTML 报告 - 同样支持
Environment variables，比如跑集成测试时设TEST_DB_URL=...
这样一套配置建好后，右键测试函数 → Run 'TestXxx' 是临时行为；而顶部切换器里选 api-integration-test 才是稳定复用的路径。
容易忽略的路径变量和跨平台兼容问题
$ProjectFileDir$ 和 $ContentRoot$ 看似一样，但行为不同：前者始终指向 .idea 所在目录（即项目根），后者可能指向模块根（尤其在多 module 项目中）。硬写绝对路径（如 C:workmyprojpi）会导致同事拉代码后配置失效。
- 一律用
$ProjectFileDir$/services/api这类变量，不要手输完整路径 - Windows 下路径分隔符用
/即可，GoLand 会自动转义，不用写\ -
Output directory如果留空，二进制默认输出到$ProjectFileDir$/out，建议统一设为$ProjectFileDir$/bin并加入.gitignore - 如果项目含 cgo，记得在
Go tool arguments加-ldflags="-s -w"减小体积，这步临时配置里没法持久化
真正卡住多人协作效率的，往往不是功能不会用，而是配置里混了本地路径、没设环境变量、或把临时配置当永久用——这些细节一旦固化进团队的 .idea/runConfigurations/ 目录，启动就真的变成一键的事了。
