七叶笔记 » golang编程 » Go 的 Debug 工具 delve 介绍

Go 的 Debug 工具 delve 介绍

delve 的汉语意思是:钻研、探索;用这个来命名一个debug工具还是非常的形象。

本文主要介绍该工具的安装与常用使用方法。是一个step-by-step的文章。目标是帮助大家学会如何使用 delve 来debug自己的代码。

安装

官网的安装文档地址: Go -delve/delve/tree/master/Documentation/installation

我再重复下如何在 Mac 上进行安装。

首先 xcode-select –install 把依赖的编译工具链安装一下。

然后通过下面的命令即可完成

$ go get github.com/go-delve/delve/cmd/dlv

这里有个注意点,大家如果使用modules的方式来管理项目,应该知道安装依赖包也是上面这个命令。所以执行上面的命令时,请确保自己不是在一个go modules的路径下。

到此,安装工作就可以完成了,可以在终端执行,可以看到如下画面:

 ➜ /Users/dayu >dlv version
Delve Debugger
Version: 1.4.0
Build: $Id: 67422e6f7148fa1efa0eac1423ab5594b223d93b $  

命令介绍

用中文来翻译下命令的含义。

 Usage:
  dlv [command]

Available Commands:
  attach      可以用来对一个正在运行的进行进行调试.
  connect     连接到headless调试器.
   core         用来调试core文件.
  dap         [EXPERIMENTAL] 启动一个Debug Adaptor Protocol (DAP)的TCP服务器来通信.
  debug       在当前包或者指定的包编译并debug程序.
  exec        如果你已经编译好了二进制,可以用该命令启动调试.
  help        帮助命令.
   test         可以用来测试自己编写的测试 源码 文件.
  trace       编译并跟踪程序.  

dlv 的命令非常多,主要介绍下 debug 与 attach 的使用。其它命令大家可以尝试下,不过一般用的也非常少!dlv test 这个也非常有用,不过使用跟debug差不多。

使用

下面将主要介绍这 debug 与 attach 如何使用,这两个命令其实主要面对两种使用场景。

  1. 用 Golang 写了一个命令行程序,想要debug一下;
  2. 写了一个 Grpc 或者 Http 服务,运行的进行进行debug;

进入调试后,他们的命令非常相似,下面开始我们的 debug 之旅。

Debug Main包程序

先来看直接使用 debug 来调试代码。调试的代码样例:

debug调试代码

此时在终端进入该文件所在路径,然后执行

dlv debug

然后会成功进入 delve 提供的debug交互界面,如下图所示。

debug交互

图中展示了三个非常常用的命令。来分别解释下。

  • b main.main

这个命令的全拼是:break main.main 用来设置断点的。除了这种写法,常用的还有使用行号来设置断点 b 9。

  • bp

这个命令是用来查找已经设置的断点的。

断点查看

查看已经设置的断点常常一个目的是用来寻找 clear 可以清除哪一个断点。

  • c

该命令是让程序运行起来。遇到设置的断点会停止。


上面只是非常基础的三个命令,我们再来继续往下走。继续看这张执行示例图

调试

这张图中的命令,都是非常常用的调试命令,来一起看看作用

  • restart

这个命令的主要作用就是一轮debug完成了,重新开始下一轮,上一次设置的断点会依然有效

  • n

这是执行下一步,也就是代码的下一行。它就是一行一行的往下,不会陷入内部去

  • s

该命令注意与 n 的区别,它是进入某个函数的内部,源码函数也能够跟踪进去,非常有利于我们学习。但是对于 goroutine 执行的函数你是无法进入的。这也很好理解,因为它的执行时机不可知。

  • p

这个是debug过程中非常重要的一个命令,打印变量的值。也是学习 go 语言的一个利器,图中可以看到一个 channel 初始化之后的内部结构体。这对我们理解源码非常有帮助。


下面的命令图中没有演示,但觉得有必要说一下。

  • so

如果用了 s 陷入到内部函数,可以快速使用该命令跳出来,回到进入点。

  • gr and grs

这两个命令是用来查看 groutine 的。

他还有非常多的命令。我们可以在使用过程中随时使用 help 来进行查看。文末我也放了一张所有命令图的翻译。

Debug运行的进程

对于运行中的进程,主要说明下如何进入 debug 交互界面,进入后的操作与上面是一样的。

假如我们有一个 http 的进程在运行,看一下如何进行 debug。示例代码如下:

 func main() {
http.HandleFunc("/", Hello)

http.ListenAndServe(":8080", nil)
}

func Hello(w http.ResponseWriter, r *http. Request ) {
a := "test"

fmt.Println(a)

time.Sleep(3 * time.Second)

fmt.Fprint(w, "Hello World")
}  

将这个 demo 给运行起来,然后找到他的进程号。执行下面的命令:

dlv attach {pid}

这个 pid 就是当前进程的进程号。

使用该方式要注意:设置完断点后记得用 c 让进程处于运行状态,否则对于 http 或者 grpc 的程序,没有办法继续接受请求,进而无法进入测试。

参考资料

[1]

相关文章