如何在ubuntu上调试golang代码

在 Ubuntu 上调试 Go 代码的高效方法

一、准备环境

安装 Go 工具链：建议 Go 1.19+，确保命令行可运行 go version。
安装调试器 Delve（推荐）：执行 go install github.com/go-delve/delve/cmd/dlv@latest，并将 $GOPATH/bin 加入 $PATH，以便全局使用 dlv。
可选 IDE：安装 VS Code 并添加官方 Go 扩展，便于图形化断点、变量与调用栈查看。

二、使用 Delve 命令行调试

基本流程
1. 在代码目录执行 dlv debug，进入调试会话；
2. 设置断点：如 break main.main 或 break main.go:10；
3. 运行到断点：continue；
4. 单步执行：next（不进入函数）/ step（进入函数）；
5. 打印变量：print variable；
6. 查看调用栈：stack；
7. 退出：quit。

示例

# 进入调试会话
dlv debug

# 设置断点
(dlv) break main.main
(dlv) break main.go:20

# 运行
(dlv) continue

# 单步与打印
(dlv) next
(dlv) print sum

# 退出
(dlv) quit

常用命令速查
- b/break：设置断点（函数名或文件:行号）
- c/continue：继续运行
- n/next：下一步（不进入函数）
- s/step：步入函数
- p/print：打印表达式/变量
- bt/stack：打印调用栈
- l/list：列出源码
- q/quit：退出调试器
  以上流程与命令适用于日常命令行调试场景。

三、使用 VS Code 图形化调试

安装 VS Code 的 Go 扩展，首次使用会提示安装依赖调试工具（会自动安装 Delve）。

生成调试配置：在 VS Code 中按 F5 或“运行和调试”面板创建 launch.json，常用配置如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Package",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}"
    }
  ]
}

调试步骤：在代码行号左侧点击设置断点，选择配置后按 F5 启动，即可在调试侧栏查看变量、调用栈并单步执行。

四、进阶与常见问题

编译优化导致变量不可见
调试时请关闭编译器优化与内联，保证断点与源码位置一致、变量可打印：

命令行构建用于调试：go build -gcflags “all=-N -l”

VS Code 预构建任务示例（在 tasks.json 中）：

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "shell",
      "label": "go_build_debug",
      "command": "go",
      "args": [
        "build",
        "-gcflags", "all=-N -l",
        "-o", "${workspaceFolder}/app_debug",
        "${workspaceFolder}/main.go"
      ]
    }
  ]
}

在 launch.json 中使用 mode: exec 并指定 program 为编译产物，配合 preLaunchTask 执行构建。

附加到已运行进程失败（ptrace 限制）
在部分 Ubuntu 上，普通用户默认不能 ptrace 附加进程。可修改内核参数：

# 临时放宽（重启失效）
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope

# 永久生效（写入配置并重启）
echo "kernel.yama.ptrace_scope = 0" | sudo tee /etc/sysctl.d/10-ptrace.conf
sudo sysctl -p /etc/sysctl.d/10-ptrace.conf

注意：放宽 ptrace 可能带来安全风险，仅在可信环境下使用。

性能问题定位（pprof）
对于 CPU/内存瓶颈，可使用 net/http/pprof：
1. 在代码中导入 _ “net/http/pprof” 并启动 http.ListenAndServe(“localhost:6060”, nil)；
2. 采集 30 秒 CPU 数据：curl http://localhost:6060/debug/pprof/profile?seconds=30 > profile.pprof；
3. 分析：go tool pprof profile.pprof，可用 top / list / web 等命令查看热点。

最新问答

相关标签