Golang在Ubuntu打包时如何调试

在 Ubuntu 上用 Go（Golang）打包/构建 时调试，通常分为 构建阶段调试、运行时调试 和 打包（如 deb / snap / docker）阶段调试。下面按常见场景梳理，基本能覆盖 90% 的情况。

一、先确认 Go 环境（基础排查）

go version
go env

重点关注：

• GOPATH / GOROOT
• GOOS / GOARCH
• CGO_ENABLED

例如：

go env | grep -E "GOPATH|GOROOT|GOOS|GOARCH|CGO_ENABLED"

二、构建（go build）时的调试方法

1️⃣ 打开详细日志（最常用）

go build -x ./...

会打印：

• 实际执行的编译命令
• 链接过程
• 使用的临时目录

✅ 适合排查：

• 构建卡住
• 找不到依赖
• CGO 编译问题

2️⃣ 查看依赖关系

go mod tidy
go mod graph
go mod why xxx

常见问题：

• 国内网络导致依赖拉不到
• 私有仓库未配置 GOPROXY

✅ 推荐配置：

go env -w GOPROXY=https://goproxy.cn,direct

3️⃣ CGO 相关调试（非常常见）

如果涉及 C 代码：

CGO_ENABLED=1 go build -x .

查看：

• 是否调用了 gcc
• include / lib 路径是否正确

常见错误：

cannot find -lxxx

✅ 排查：

dpkg -l | grep libxxx
sudo apt install libxxx-dev

三、运行时调试（程序能跑但行为不对）

1️⃣ 使用 Delve（Go 官方推荐调试器）

安装

go install github.com/go-delve/delve/cmd/dlv@latest

调试当前程序

dlv debug ./main.go

常用命令：

b main.main        # 打断点
c                  # 继续
n                  # 下一步
s                  # 进入函数
p variable         # 打印变量

✅ 适合：

• 打包前逻辑验证
• 排查 panic / 死循环

2️⃣ 打印构建信息（编译时注入变量）

go build -ldflags "-X main.Version=1.0.0 -X main.BuildTime=$(date)" main.go

代码中：

var Version string
var BuildTime string

✅ 常用于：

• 确认打包的是哪个版本
• 区分 debug / release

四、Ubuntu 打包（deb / snap / docker）调试

1️⃣ deb 打包调试

查看构建失败原因

dpkg-buildpackage -us -uc -b

查看临时目录

ls debian/tmp

常见坑

• go build 使用的是 root 用户
• GOPATH 在打包环境中不存在

✅ 解决方法： 在 debian/rules 中显式设置：

export GOPATH=/usr/share/gocode
export GOFLAGS=-mod=vendor

2️⃣ Docker 构建调试

查看构建失败层

docker build --progress=plain .

进入中间容器

docker run -it <image-id> /bin/bash

✅ 常用技巧：

RUN go build -x ./...

3️⃣ Snap 打包调试

snapcraft --debug

进入调试 shell：

snapcraft cleanbuild

五、常见错误速查表

六、推荐调试组合（实战）

# 1. 构建阶段
CGO_ENABLED=1 go build -x ./...

# 2. 运行阶段
dlv exec ./myapp

# 3. 打包阶段
dpkg-buildpackage -us -uc -b

如果你能贴出：

• go build / go mod 的具体报错
• 是 deb / snap / Docker / 裸二进制
• Ubuntu 版本（20.04 / 22.04 / 24.04）

我可以给你一个 针对性的调试方案。