最近我开始学习 Go 编程语言了,在本文中,我们将探讨一种名为 Delve 的调试器。Delve 是专门用来调试 Go 程序的工具,我们会借助一些 Go 示例代码来了解下它的一些功能。不要担心这里展示的 Go 示例代码;即使你之前没有写过 Go 代码也能看懂。Go 的目标之一是简单,因此代码是始终如一的,理解和解释起来都很容易。
Delve 是能让调试变成轻而易举的事的万能工具包。
你上次尝试去学习一种新的编程语言时什么时候?你有没有持之以恒,你是那些在新事物发布的第一时间就勇敢地去尝试的一员吗?不管怎样,学习一种新的语言也许非常有用,也会有很多乐趣。
你尝试着写简单的 “Hello, world!”,然后写一些示例代码并执行,继续做一些小的修改,之后继续前进。我敢保证我们都有过这个经历,不论我们使用哪种技术。假如你尝试用一段时间一种语言,并且你希望能够精通它,那么有一些事物能在你的进取之路上帮助你。
其中之一就是调试器。有些人喜欢在代码中用简单的 “print” 语句进行调试,这种方式很适合代码量少的简单程序;然而,如果你处理的是有多个开发者和几千行代码的大型项目,你应该使用调试器。
最近我开始学习 Go 编程语言了,在本文中,我们将探讨一种名为 Delve 的调试器。Delve 是专门用来调试 Go 程序的工具,我们会借助一些 Go 示例代码来了解下它的一些功能。不要担心这里展示的 Go 示例代码;即使你之前没有写过 Go 代码也能看懂。Go 的目标之一是简单,因此代码是始终如一的,理解和解释起来都很容易。
Delve 介绍
Delve 是托管在GitHub上的一个开源项目。
它自己的文档中写道:
Delve 是 Go 编程语言的调试器。该项目的目标是为 Go 提供一个简单、全功能的调试工具。Delve 应该是易于调用和易于使用的。当你使用调试器时,事情可能不会按你的思路运行。如果你这样想,那么你不适合用 Delve。
让我们来近距离看一下。
我的测试系统是运行着 Fedora Linux 的笔记本电脑,Go 编译器版本如下:
$ cat /etc/fedora-release
Fedora release 30 (Thirty)
$
$ go version
go version go1.12.17 linux/amd64
$
Golang 安装
如果你没有安装 Go,你可以运行下面的命令,很轻松地就可以从配置的仓库中获取。
$ dnf install golang.x86_64
或者,你可以在安装页面找到适合你的操作系统的其他安装版本。
在开始之前,请先确认已经设置好了 Go 工具依赖的下列各个路径。如果这些路径没有设置,有些示例可能不能正常运行。你可以在 SHELL 的 RC 文件中轻松设置这些环境变量,我的机器上是在$HOME/bashrc
文件中设置的。
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
Delve 安装
你可以像下面那样,通过运行一个简单的go get
命令来安装 Delve。go get
是 Golang 从外部源下载和安装需要的包的方式。如果你安装过程中遇到了问题,可以查看Delve 安装教程。
$ go get -u github.com/go-delve/delve/cmd/dlv
$
运行上面的命令,就会把 Delve 下载到你的$GOPATH
的位置,如果你没有把$GOPATH
设置成其他值,那么默认情况下$GOPATH
和$HOME/go
是同一个路径。
你可以进入go/
目录,你可以在bin/
目录下看到dlv
。
$ ls -l $HOME/go
total 8
drwxrwxr-x. 2 user user 4096 May 25 19:11 bin
drwxrwxr-x. 4 user user 4096 May 25 19:21 src
$
$ ls -l ~/go/bin/
total 19596
-rwxrwxr-x. 1 user user 20062654 May 25 19:17 dlv
$
因为你把 Delve 安装到了$GOPATH
,所以你可以像运行普通的 shell 命令一样运行它,即每次运行时你不必先进入它所在的目录。你可以通过version
选项来验证dlv
是否正确安装。示例中安装的版本是 1.4.1。
$ which dlv
~/go/bin/dlv
$
$ dlv version
Delve Debugger
Version: 1.4.1
Build: $Id: bda606147ff48b58bde39e20b9e11378eaa4db46 $
$
现在,我们一起在 Go 程序中使用 Delve 来理解下它的功能以及如何使用它们。我们先来写一个hello.go
,简单地打印一条Hello, world!
信息。
记着,我把这些示例程序放到了$GOBIN
目录下。
$ pwd
/home/user/go/gobin
$
$ cat hello.go
package main
import "fmt"
func main() {
fmt.Println("Hello, world!")
}
$
运行build
命令来编译一个 Go 程序,它的输入是.go
后缀的文件。如果程序没有语法错误,Go 编译器把它编译成一个二进制可执行文件。这个文件可以被直接运行,运行后我们会在屏幕上看到Hello, world!
信息。
$ go build hello.go
$
$ ls -l hello
-rwxrwxr-x. 1 user user 1997284 May 26 12:13 hello
$
$ ./hello
Hello, world!
$
在 Delve 中加载程序
把一个程序加载进 Delve 调试器有两种方式。
在源码编译成二进制文件之前使用 debug 参数
第一种方式是在需要时对源码使用debug
命令。Delve 会为你编译出一个名为__debug_bin
的二进制文件,并把它加载进调试器。
在这个例子中,你可以进入hello.go
所在的目录,然后运行dlv debug
命令。如果目录中有多个源文件且每个文件都有自己的主函数,Delve 则可能抛出错误,它期望的是单个程序或从单个项目构建成单个二进制文件。如果出现了这种错误,那么你就应该用下面展示的第二种方式。
$ ls -l
total 4
-rw-rw-r--. 1 user user 74 Jun 4 11:48 hello.go
$
$ dlv debug
Type 'help' for list of commands.
(dlv)
现在打开另一个终端,列出目录下的文件。你可以看到一个多出来的__debug_bin
二进制文件,这个文件是由源码编译生成的,并会加载进调试器。你现在可以回到dlv
提示框继续使用 Delve。
$ ls -l
total 2036
-rwxrwxr-x. 1 user user 2077085 Jun 4 11:48 __debug_bin
-rw-rw-r--. 1 user user 74 Jun 4 11:48 hello.go
$
使用 exec 参数
如果你已经有提前编译好的 Go 程序或者已经用go build
命令编译完成了,不想再用 Delve 编译出__debug_bin
二进制文件,那么第二种把程序加载进 Delve 的方法在这些情况下会很有用。在上述情况下,你可以使用exec
命令来把整个目录加载进 Delve 调试器。
0
$ dnf install golang.x86_64
查看 Delve 帮助信息
在dlv
提示符中,你可以运行help
来查看 Delve 提供的多种帮助选项。命令列表相当长,这里我们只列举一些重要的功能。下面是 Delve 的功能概览。
1
$ dnf install golang.x86_64
设置断点
现在我们已经把 hello.go 程序加载进了 Delve 调试器,我们在主函数处设置断点,稍后来确认它。在 Go 中,主程序从main.main
处开始执行,因此你需要给这个名字提供个break
命令。之后,我们可以用breakpoints
命令来检查断点是否正确设置了。
不要忘了你还可以用命令简写,因此你可以用b main.main
来代替break main.main
,两者效果相同,bp
和breakpoints
同理。你可以通过运行help
命令查看帮助信息来找到你想要的命令简写。
2
$ dnf install golang.x86_64
程序继续执行
现在,我们用continue
来继续运行程序。它会运行到断点处中止,在我们的例子中,会运行到主函数的main.main
处中止。从这里开始,我们可以用next
命令来逐行执行程序。请注意,当我们运行到fmt.Println("Hello, world!")
处时,即使我们还在调试器里,我们也能看到打印到屏幕的Hello, world!
。
3
$ dnf install golang.x86_64
退出 Delve
你随时可以运行quit
命令来退出调试器,退出之后你会回到 shell 提示符。相当简单,对吗?
4
$ dnf install golang.x86_64
Delve 的其他功能
我们用其他的 Go 程序来探索下 Delve 的其他功能。这次,我们从golang 教程中找了一个程序。如果你要学习 Go 语言,那么 Golang 教程应该是你的第一站。
下面的程序,functions.go
中简单展示了 Go 程序中是怎样定义和调用函数的。这里,我们有一个简单的把两数相加并返回和值的add()
函数。你可以像下面那样构建程序并运行它。
5
$ dnf install golang.x86_64
你可以像下面那样构建和运行程序。
6
$ dnf install golang.x86_64
进入函数
跟前面展示的一样,我们用前面提到的一个选项来把二进制文件加载进 Delve 调试器,再一次在main.main
处设置断点,继续运行程序直到断点处。然后执行next
直到fmt.Println(add(42, 13))
处;这里我们调用了add()
函数。我们可以像下面展示的那样,用 Delve 的step
命令从main
函数进入add()
函数。
7
$ dnf install golang.x86_64
使用文件名:行号
来设置断点
上面的例子中,我们经过main
函数进入了add()
函数,但是你也可以在你想加断点的地方直接使用“文件名:行号”的组合。下面是在add()
函数开始处加断点的另一种方式。
8
$ dnf install golang.x86_64
查看当前的栈信息
现在我们运行到了add()
函数,我们可以在 Delve 中用stack
命令查看当前栈的内容。这里在0
位置展示了栈顶的函数add()
,紧接着在1
位置展示了调用add()
函数的main.main
。在main.main
下面的函数属于 Go 运行时,是用来处理加载和执行该程序的。
9
$ dnf install golang.x86_64
在帧之间跳转
在 Delve 中我们可以用frame
命令实现帧之间的跳转。在下面的例子中,我们用frame
实现了从add()
帧跳到main.main
帧,以此类推。
0
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
打印函数参数
一个函数通常会接收多个参数。在add()
函数中,它的入参是两个整型。Delve 有个便捷的args
命令,它能打印出命令行传给函数的参数。
1
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
查看反汇编码
由于我们是调试编译出的二进制文件,因此如果我们能查看编译器生成的汇编语言指令将会非常有用。Delve 提供了一个disassemble
命令来查看这些指令。在下面的例子中,我们用它来查看add()
函数的汇编指令。
2
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
单步退出函数
另一个功能是stepout
,这个功能可以让我们跳回到函数被调用的地方。在我们的例子中,如果我们想回到main.main
函数,我们只需要简单地运行stepout
命令,它就会把我们带回去。在我们调试大型代码库时,这个功能会是一个非常便捷的工具。
3
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
打印变量信息
我们一起通过Go 教程的另一个示例程序来看下 Delve 是怎么处理 Go 中的变量的。下面的示例程序定义和初始化了一些不同类型的变量。你可以构建和运行程序。
4
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
像前面说过的那样,用delve debug
在调试器中加载程序。你可以在 Delve 中用print
命令通过变量名来展示他们当前的值。
5
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
或者,你还可以用locals
命令来打印函数内所有的局部变量。
6
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
如果你不知道变量的类型,你可以用whatis
命令来通过变量名来打印它的类型。
7
$ go env | grep GOPATH
GOPATH="/home/user/go"
$
$ go env | grep GOBIN
GOBIN="/home/user/go/gobin"
$
总结
现在我们只是了解了 Delve 所有功能的皮毛。你可以自己去查看帮助内容,尝试下其它的命令。你还可以把 Delve 绑定到运行中的 Go 程序上(守护进程!),如果你安装了 Go 源码库,你甚至可以用 Delve 导出 Golang 库内部的信息。勇敢去探索吧!
知优网 » 使用Delve代替Println来调试Go程序