Go 语言源码级调试器 Delve

简介: Go 语言源码级调试器 Delve

介绍

Delve 是一个简单、强大和易用的 Go 语言源代码层级的调试器,也是 Go 官方推荐使用的调试器。

安装

Delve 安装非常简单,如果读者朋友使用的是 Go 1.16 或更高版本,可以直接使用 go install 安装:

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

如果读者朋友们使用的是低于 Go 1.16 的版本,可是先下载 Delve 源码,然后使用 go install 安装:

git clone https://github.com/go-delve/delve
cd delve
go install github.com/go-delve/delve/cmd/dlv

安装完成之后,可以使用 go help install 查看 dlv 可执行文件的详细位置。我建议读者朋友们将 dlv可执行文件,配置到 PATH 环境变量。

需要注意的是,如果读者朋友们使用的是 macOS,还需要安装命令行开发工具:

xcode-select --install

为了避免每次使用 dlv 都需要授权允许使用 debugger,建议读者朋友们开启开发者模式:

sudo /usr/sbin/DevToolsSecurity -enable

03

实践

在完成 Part 02 中的所有操作之后,我们使用 dlv version 检查 dlv 可执行程序是否已可以使用。

我们可以使用 dlv 的任意可用命令启动一个调式会话,比较常用的命令是 dlv debugdlv execdlv test。限于篇幅,本文我们介绍 dlv debug 的使用方法。

示例代码:

package main
import (
    "fmt"
)
func main() {
    a := 1
    b := 2
    c := sum(a, b)
    fmt.Println(c)
}
func sum(a, b int) int {
    res :=  a + b
    return res
}

阅读上面这段我们将用于调试会话的代码示例,它包含一个 main 函数和一个 sum 函数,main 函数中定义变量 a 和变量 b,调用 sub 函数,并将返回结果赋值给变量 c,最后打印变量 c 的值。

启动一个调试会话:

[root@VM-8-14-centos work]# dlv debug
Type 'help' for list of commands.
(dlv)

阅读上面这段代码,我们使用 dlv debug 启动一个调试会话,在没有任何参数的情况下,Delve 编译并开始调试当前目录中的 main 包。

我们也可以指定一个文件名,Delve 将会编译该指定文件的 main 包,并启动一个调试会话。

[root@VM-8-14-centos work]# dlv debug main.go
Type 'help' for list of commands.
(dlv)

调试会话启动后,我们可以使用调试命令进行调试程序。

list 命令:

dlv debug
Type 'help' for list of commands.
(dlv) list main.main
Showing /work/main.go:7 (PC: 0x49670a)
     2:
     3: import (
     4:  "fmt"
     5: )
     6:
     7: func main() {
     8:  a := 1
     9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
(dlv) list ./main.go:7
Showing /work/main.go:7 (PC: 0x49670a)
     2:
     3: import (
     4:  "fmt"
     5: )
     6:
     7: func main() {
     8:  a := 1
     9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
(dlv)

调试会话启动后,我们可以使用 list 命令列出指定位置的源码,包含两种方式,第一种方式是 <package name>.<func name>,第二种方式是 <file name>:<line number>

break 命令:

dlv debug
Type 'help' for list of commands.
(dlv) break main.main
Breakpoint 1 set at 0x49670a for main.main() ./main.go:7
(dlv)

我们可以使用 break 命令添加断点,和 list 命令一样,添加断点的位置,也可以使用上述两种方式。

我们可以使用 breakpoints 命令,列出所有断点,可以使用 clear 命令删除指定断点,可以使用 clearall 删除所有断定。

continue、next、step、stepout 和 print 命令:

dlv debug
Type 'help' for list of commands.
(dlv) break main.main
Breakpoint 1 set at 0x49670a for main.main() ./main.go:7
(dlv) continue
> main.main() ./main.go:7 (hits goroutine(1):1 total:1) (PC: 0x49670a)
     2:
     3: import (
     4:  "fmt"
     5: )
     6:
=>   7: func main() {
     8:  a := 1
     9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
(dlv) next
> main.main() ./main.go:8 (PC: 0x496718)
     3: import (
     4:  "fmt"
     5: )
     6:
     7: func main() {
=>   8:  a := 1
     9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
(dlv) next
> main.main() ./main.go:9 (PC: 0x496721)
     4:  "fmt"
     5: )
     6:
     7: func main() {
     8:  a := 1
=>   9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
(dlv) next
> main.main() ./main.go:10 (PC: 0x49672a)
     5: )
     6:
     7: func main() {
     8:  a := 1
     9:  b := 2
=>  10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
    15:  res :=  a + b
(dlv) print a
1
(dlv) print b
2
(dlv) step
> main.sum() ./main.go:14 (PC: 0x4967e0)
     9:  b := 2
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
=>  14: func sum(a, b int) int {
    15:  res :=  a + b
    16:  return res
    17: }
(dlv) next
> main.sum() ./main.go:15 (PC: 0x496800)
    10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
=>  15:  res :=  a + b
    16:  return res
    17: }
(dlv) next
> main.sum() ./main.go:16 (PC: 0x49680f)
    11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
    15:  res :=  a + b
=>  16:  return res
    17: }
(dlv) next
> main.main() ./main.go:10 (PC: 0x496739)
Values returned:
 ~r0: 3
     5: )
     6:
     7: func main() {
     8:  a := 1
     9:  b := 2
=>  10:  c := sum(a, b)
    11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
    15:  res :=  a + b
(dlv) next
> main.main() ./main.go:11 (PC: 0x49673e)
     6:
     7: func main() {
     8:  a := 1
     9:  b := 2
    10:  c := sum(a, b)
=>  11:  fmt.Println(c)
    12: }
    13:
    14: func sum(a, b int) int {
    15:  res :=  a + b
    16:  return res
(dlv) print c
3
(dlv)

阅读上面这段代码,我们使用 Delve 添加断点后,执行 continue 命令,程序将执行到断点位置;执行 next 命令,程序继续执行下一行代码;执行 step 命令,程序步入到调用函数内部;执行 stepout 命令,程序步出到调用函数的调用位置;执行 print 命令,打印指定参数的值。

读者朋友们使用以上命令,可以满足大部分调试场景。为了方便理解,以上示例中使用的命令都没有使用简写形式,在实际使用时,使用简写形式会更加便捷。

简写形式:

  • break(b)
  • continue(c)
  • next(n)
  • step(s)
  • stepout(so)
  • print(p)

04

总结

本文我们简单介绍 Go 语言调试器 Delve 的基本使用方式,读者朋友们可以在程序调试时将 Delve 使用起来,替换使用 print 打印的形式调试代码。

关于 Delve 的高级功能,例如调试 goroutines、将调试器附加到现有进程、远程调试以及从 VSCode 编辑器或 Goland IDE 使用 Delve。感兴趣的读者朋友们可以参考 Delve 的帮助文档。

推荐阅读:

参考资料:

  1. https://go.dev/doc/gdb
  2. https://github.com/go-delve/delve/tree/master/Documentation
目录
相关文章
|
15天前
|
Go
go语言中的数据类型
go语言中的数据类型
13 0
|
20天前
|
存储 安全 Go
掌握Go语言:Go语言类型转换,无缝处理数据类型、接口和自定义类型的转换细节解析(29)
掌握Go语言:Go语言类型转换,无缝处理数据类型、接口和自定义类型的转换细节解析(29)
|
18小时前
|
程序员 Go API
【Go语言快速上手(二)】 分支与循环&函数讲解
【Go语言快速上手(二)】 分支与循环&函数讲解
|
20小时前
|
Go
Golang深入浅出之-Go语言基础语法:变量声明与赋值
【4月更文挑战第20天】本文介绍了Go语言中变量声明与赋值的基础知识,包括使用`var`关键字和简短声明`:=`的方式,以及多变量声明与赋值。强调了变量作用域、遮蔽、初始化与零值的重要性,并提醒读者注意类型推断时的一致性。了解这些概念有助于避免常见错误,提高编程技能和面试表现。
7 0
|
20小时前
|
编译器 Go 开发者
Go语言入门|包、关键字和标识符
Go语言入门|包、关键字和标识符
8 0
|
2天前
|
数据采集 存储 Go
使用Go语言和chromedp库下载Instagram图片:简易指南
Go语言爬虫示例使用chromedp库下载Instagram图片,关键步骤包括设置代理IP、创建带代理的浏览器上下文及执行任务,如导航至用户页面、截图并存储图片。代码中新增`analyzeAndStoreImage`函数对图片进行分析和分类后存储。注意Instagram的反爬策略可能需要代码适时调整。
使用Go语言和chromedp库下载Instagram图片:简易指南
|
4天前
|
API Go
使用Go语言通过API获取代理IP并使用获取到的代理IP
使用Go语言通过API获取代理IP并使用获取到的代理IP
|
5天前
|
前端开发 Java Go
开发语言详解(python、java、Go(Golong)。。。。)
开发语言详解(python、java、Go(Golong)。。。。)
|
14天前
|
存储 Java 编译器
go语言基础语法
go语言基础语法
|
20天前
|
存储 缓存 安全
掌握Go语言:Go语言Map,高效键值对集合的应用与注意事项详解(26)
掌握Go语言:Go语言Map,高效键值对集合的应用与注意事项详解(26)

热门文章

最新文章