GoLand需通过External Tool配置go generate等CLI命令：先在Settings中定义工具（命令go、参数generate -v ./、工作目录$ProjectFileDir$），再于Run Configuration的Before launch中添加；go mod tidy失败主因是工作目录非项目根或与Build project冲突；多任务按序执行，任一失败则中断；环境变量与工作目录必须匹配，否则命令静默失效。
GoLand 不支持直接写 Bash/PowerShell 脚本块作为“启动前”任务，必须通过 External Tool 或 Run Configuration 间接调用命令。
如何添加 go generate 或 swag init 这类 CLI 命令
在 Run | Edit Configurations 中选中你的 Go Build 配置 → 切换到 Configuration 标签页 → 展开 Before launch 区域 → 点击 + → 选择 Run External Tool。
首次使用需先在 Settings | Tools | External Tools 中定义该工具：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 命令填
go，参数填generate -v ./（注意路径是相对于项目根目录的） - 工作目录设为
$ProjectFileDir$ - 若需指定构建目标（如
GOOS=linux），不能写在参数里，得在Environment variables字段单独加：GOOS=linux;GOARCH=amd64 - 勾选
Run on debug才能在 Debug 模式下也触发
为什么 go mod tidy 总是失败或被跳过
失败主因不是命令错，而是上下文缺失：
- 确保
Working directory设为含go.mod的项目根目录，别用$ProjectFileDir$/cmd这类子路径 - 不要在
Before launch里重复添加Build project—— 它会触发 GoLand 自带构建流程，可能和go mod tidy冲突 - 如果项目启用了
vendor，go mod tidy可能因只读文件或权限报错；此时建议改用go mod vendor，并配合 Shell Script 配置实现“仅当 vendor 不存在时运行”逻辑
多个任务的执行顺序与失败控制
所有 Before launch 项按列表从上到下执行，任一任务返回非零退出码，后续步骤立即中止，且默认不继续编译。
- 想让某次调试跳过某个任务？临时取消勾选对应条目即可
- 想复用已有脚本（比如一个封装了 lint + format 的
run-precheck.sh）？先在External Tools里注册它，再加入Before launch - 不支持把多条命令塞进一行参数里（如
go generate && go fmt ./...），每条命令必须独立配置为一个 External Tool
最容易被忽略的是环境变量和工作目录的耦合关系：哪怕命令本身完全正确，只要 GO111MODULE=on 没生效、或 go.mod 不在当前工作目录下，go mod 类命令就会静默失败或降级行为。务必用终端 cd 进项目根目录后手动跑一遍相同命令，确认输出符合预期，再搬进 GoLand 配置里。
