go build仅完成编译,真实项目还需跨平台构建、注入版本、清理产物、打包压缩、校验依赖、触发测试等,脚本固化流程保障一致性、可复现性与CI/CD兼容性。

go build 命令本身就能构建,为什么还要写脚本?
因为 go build 只解决“编译出二进制”这一步,而真实项目需要:跨平台编译、注入版本信息、清理旧产物、打包压缩、校验依赖、触发测试——这些没法靠一条命令完成。
手动敲一串命令容易漏、难复现、不一致。脚本把重复逻辑固化下来,CI/CD 流水线也只认它。
- 没脚本时,每次发布都要查一遍
GOOS/GOARCH组合,还可能忘记加-ldflags "-s -w" - 团队成员本地构建结果不一致(比如有人用
go build main.go,有人用go build -o ./bin/app .) -
go mod tidy被跳过,导致go.sum过期,CI 构建失败
Makefile 是最轻量又最通用的选择
不用额外装工具,make 在 Linux/macOS 默认自带,Windows 上装 Git Bash 也能跑。比自己写 deploy.sh 更易维护,比引入 mage 或 task 更少依赖。
一个最小可用的 Makefile 示例:
立即学习“go语言免费学习笔记(深入)”;
build: go mod tidy go build -o ./bin/app -ldflags "-s -w -X main.version=$(shell git describe --tags 2>/dev/null || echo dev)" . linux-amd64: GOOS=linux GOARCH=amd64 make build darwin-arm64: GOOS=darwin GOARCH=arm64 make build clean: rm -rf ./bin
-
make build自动执行go mod tidy,避免依赖不一致 - 版本号从
git describe获取,没 tag 就 fallback 到dev,比硬编码更可靠 - 交叉编译目标直接复用
build规则,避免重复写go build参数 -
clean清掉./bin,不碰go.mod或缓存,安全
什么时候该用 Go 写构建脚本而不是 Makefile?
当构建流程需要条件判断、HTTP 请求、JSON 解析、并发执行多任务,或者要嵌入到 CI/CD 的 Go 工具链里时,go run build.go 比 shell 更可控。
比如你需要:
- 从远程配置中心拉取环境变量生成
configs/prod.yaml - 调用 GitHub API 获取最新 release tag,并自动打新 tag
- 并发构建多个子服务(
cmd/api、cmd/worker),并汇总构建耗时
这时写一个 build.go 更合适:
package main
import (
"os/exec"
"log"
)
func main() {
for _, svc := range []string{"api", "worker"} {
cmd := exec.Command("go", "build", "-o", "bin/"+svc, "./cmd/"+svc)
if err := cmd.Run(); err != nil {
log.Fatal(err)
}
}
}
注意:不要在 build.go 里做部署操作(如 SSH 登录服务器),那是运维脚本的事;构建脚本只负责产出可部署物。
容易被忽略的三个细节
很多团队写了脚本但依然踩坑,问题常出在这三处:
-
go build默认只编译当前目录,如果入口在cmd/myapp/main.go,必须写成go build -o app ./cmd/myapp,否则报no Go files in ... -
GOOS/GOARCH环境变量只影响当前命令,make linux-amd64里不能写成export GOOS=linux,得用GOOS=linux make build这种形式 - 脚本里用
$(shell ...)或os/exec.Command获取 Git 信息时,要处理工作区脏(uncommitted changes)的情况,否则git describe可能失败


















