Golang在Debian中的调试技巧

Golang在Debian中的调试技巧

1. 使用Delve调试器（推荐）

要是想在Debian下安心调试Go代码，Delve得算头号选手。这玩意儿是专门为Go量身打造的调试器，断点、单步执行、变量查看和修改——该有的功能一个不落，用起来很顺手。

• 安装Delve：终端里来一句 go get -u github.com/go-delve/delve/cmd/dlv，它就会自动下载并装到 $GOPATH/bin 里，省心。
• 启动调试会话：切到项目目录，执行 dlv debug ./main.go（假设入口文件是 main.go），就能进入交互式调试界面。
• 常用命令：
  • break main.go:10：在 main.go 第10行设个断点；
  • continue（或 c）：继续跑，直到下一个断点；
  • next（或 n）：单步走，不钻进函数内部；
  • step（或 s）：钻进函数里面看看；
  • print variable_name（或 p）：打印变量值；
  • set variable_name = new_value：直接改变量值，调试时很有用；
  • clear：删掉当前断点；
  • trace main.go:10：设置跟踪点，执行到那行会自动打印信息，相当于轻量级日志。

2. 使用GDB调试器（备选）

GDB是通用的调试器，虽然不专为Go设计，但加上调试信息也能凑合用，尤其适合那些已经习惯GDB操作的老手。

• 安装GDB：终端里跑 sudo apt-get install gdb，完事。
• 编译带调试信息的程序：用 go build -gcflags "-N -l" -o debug-demo debug-demo.go 来编译。留意 -N 是禁用优化，-l 是禁用内联，这样才能保留调试符号，不然调试信息不全。
• 启动GDB调试：执行 gdb ./debug-demo 进入GDB界面，然后就可以用 break main.main（在 main 函数设断点）、run（启动程序）、next（单步）、print variable_name（打印变量）这些老命令了。

3. 集成开发环境（IDE）调试

图形化界面调试效率更高，VS Code和GoLand都支持，配置起来也不复杂。

• Visual Studio Code（VS Code）：
  • 安装Go插件：打开VS Code，进扩展市场搜“Go”安装就行；
  • 配置 launch.json：在项目根目录创建 .vscode/launch.json，贴入以下内容：

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

  • 启动调试：打开 main.go，点一下行号左侧设个断点，按 F5 开始调试，用工具栏控制执行流程。
• GoLand：
  • 安装GoLand：从JetBrains官网下载Debian安装包，按提示装好；
  • 导入项目：打开GoLand，直接导入Golang项目；
  • 设置断点：在代码行左侧单击一下；
  • 启动调试：点工具栏绿色三角形（或按 Shift+F10），进入调试模式后，变量查看、函数进出这些功能都一目了然。

4. 日志记录

有时候调式器不方便，用日志记录反而更直接。Go标准库的 log 包就够用，第三方库像 logrus 功能更丰富。

• 基础日志：在代码里加 log.Println("程序启动")、log.Printf("变量值：%v", variable)，默认输出到标准输出；
• 自定义日志：通过 log.SetOutput(os.Stdout) 可以设输出目标（比如写入文件），再用 log.SetFlags(log.LstdFlags|log.Lshortfile) 加上时间戳和文件名，这样一眼就能看出日志来源，排查问题方便很多。

5. 性能分析（pprof）

遇到性能瓶颈别瞎猜，用 pprof 工具一抓一个准，它能分析CPU、内存的使用情况，定位到具体函数。

• 插入分析点：在代码里导入 _ "net/http/pprof"，并启动HTTP服务：

  import _ "net/http/pprof"func main() {go func() {log.Println(http.ListenAndServe("localhost:6060", nil))}()// 程序逻辑}

• 分析数据：
  • CPU分析：运行 go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30，采集30秒CPU数据；
  • 内存分析：运行 go tool pprof http://localhost:6060/debug/pprof/heap；
  • 交互式分析：进入pprof界面后，用 top 看占用最高的函数，用 list 函数名 查看函数内代码耗时，用 web 生成调用图，一目了然。

6. 单元测试

单元测试是验证代码逻辑正确性的基本功，Go的 testing 包用起来很轻量，能快速定位函数级问题。

• 编写测试用例：创建 xxx_test.go 文件，写测试函数要以 Test 开头，比如：

  import "testing"func TestAdd(t *testing.T) {result := Add(1, 2)if result != 3 {t.Errorf("Add(1, 2) = %d; want 3", result)}}

• 运行测试：终端里执行 go test -v（加 -v 能看到详细输出），结果清清爽爽。