Golang的Debug工具delve介绍

悠悠 2023-02-14 01:16 8阅读 0赞

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

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

# 安装 #

官网的安装文档地址：https://github.com/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` 来调试代码。调试的代码样例：

![3c32d8f7e59802df310141ba9f54773e.png][]

debug调试代码

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

> dlv debug

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

![5f6fb86e9d8a28ffa20e9f3907f52b76.png][]

debug交互

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

*  b main.main

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

*  bp

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

![7e0808325218a22260fb3c254cea3889.png][]

断点查看

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

*  c

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

--------------------

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

![818231ab9f8b69583d9c50b0a43e1592.png][]

调试

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

*  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 的程序，没有办法继续接受请求，进而无法进入测试。

![3b961eec338f1fff0f40a4f76bcf9deb.png][]

**参考资料**

\[1\] https://github.com/go-delve/delve

--------------------

**程序改变的不止是世界**

**也改变了你我的头发**

公众号ID

dayuTalk

![2455ba503606dd46c24ec80c9d4a5b2f.png][]

[3c32d8f7e59802df310141ba9f54773e.png]: https://img-blog.csdnimg.cn/img_convert/3c32d8f7e59802df310141ba9f54773e.png
[5f6fb86e9d8a28ffa20e9f3907f52b76.png]: https://img-blog.csdnimg.cn/img_convert/5f6fb86e9d8a28ffa20e9f3907f52b76.png
[7e0808325218a22260fb3c254cea3889.png]: https://img-blog.csdnimg.cn/img_convert/7e0808325218a22260fb3c254cea3889.png
[818231ab9f8b69583d9c50b0a43e1592.png]: https://img-blog.csdnimg.cn/img_convert/818231ab9f8b69583d9c50b0a43e1592.png
[3b961eec338f1fff0f40a4f76bcf9deb.png]: https://img-blog.csdnimg.cn/img_convert/3b961eec338f1fff0f40a4f76bcf9deb.png
[2455ba503606dd46c24ec80c9d4a5b2f.png]: https://img-blog.csdnimg.cn/img_convert/2455ba503606dd46c24ec80c9d4a5b2f.png