goland的“启动前”任务支持运行已安装cli工具（如go generate、swag init）、已配置的run configuration（如其他go build或shell script）及部分jetbrains通用动作（如build project），不支持直接嵌入bash/powershell脚本块。
GoLand 的“启动前”任务支持哪些操作
GoLand 允许在 Go Build 配置执行编译前，插入自定义操作，比如生成代码、更新依赖、校验格式、运行 lint 或预处理模板。这些操作不是靠 shell 脚本硬编码进 IDE，而是通过内置的“外部工具”或“运行配置”触发——本质是调用命令行工具，并由 GoLand 管理其执行时机与失败行为。
它不支持直接写一段 Bash/PowerShell 脚本块，但能可靠执行：已安装的 CLI 工具（如 swag init、stringer、go generate）、已配置的 Run Configuration（比如另一个 Go Build 或 Shell Script 配置），以及部分 JetBrains 通用动作（如“Build project”）。
如何添加 go generate 或 swag init 这类命令
在 Run | Edit Configurations... 中选中你的 Go Build 配置 → 切换到 Configuration 标签页 → 展开 Before launch 区域 → 点击 + → 选择 Run External Tool。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 首次使用需先在
Settings | Tools | External Tools中定义该工具：命令填go，参数填generate -v ./...（注意路径要相对于项目根目录）；工作目录设为$ProjectFileDir$ - 如果命令依赖环境变量（如
GOOS=linux），不能直接写在“参数”里，得在“Environment variables”字段中单独添加：GOOS=linux;GOARCH=amd64 - 勾选
Run on debug才能在 Debug 模式下也触发；若某次调试不想跑，可临时取消勾选该条目 - 多个任务按列表顺序执行，任一失败（非零退出码）将中断后续步骤，默认不继续编译
为什么 go mod tidy 总是失败或被跳过
go mod tidy 在 “Before launch” 中失败，常见原因不是命令本身错，而是工作目录或模块上下文缺失：
- 确保
Working directory设为项目根目录（即含go.mod的目录），不要用$ProjectFileDir$的子目录路径 - 避免在
Before launch里重复添加“Build project”动作——它会触发 GoLand 自带的构建流程，可能和go mod tidy冲突或导致竞态 - 如果项目用了 vendor，
go mod tidy可能因权限或只读文件报错；此时建议改用go mod vendor并设为“仅当 vendor 目录不存在时运行”逻辑（需配合 Shell Script 配置实现） - GoLand 默认不会捕获
go mod tidy的 stdout/stderr，出错时只显示“Exit code: 1”，务必点开右下角弹出的“Run”窗口看完整输出
Shell Script 配置 vs 外部工具：选哪个
当需要串行执行多条命令（比如先 git clean -fdq，再 go generate，最后 go fmt -w .），External Tool 就力不从心了。这时应新建一个 Shell Script 类型的 Run Configuration：
- 路径填脚本绝对路径（如
$ProjectFileDir$/scripts/prebuild.sh），或直接粘贴内联脚本（GoLand 支持） - 关键点：
Working directory必须显式设为$ProjectFileDir$，否则./解析会错位 - Windows 用户注意：GoLand 默认调用
cmd.exe，不是 PowerShell；如需 PowerShell，命令行填powershell.exe，参数填-ExecutionPolicy Bypass -File "path\to\script.ps1" - 该配置可以被其他
Go Build配置在Before launch中引用，且支持“失败时停止构建”开关
真正容易被忽略的是：GoLand 对 Shell Script 的错误码判断很严格，哪怕脚本里只有一行 echo "done" 后面没加 exit 0，某些 shell 环境下也可能返回非零码导致构建中断。
