Go delve调试工具的简单应用

2023-12-20 04:45

本文主要是介绍Go delve调试工具的简单应用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Delve是个啥

Delve is a debugger for the Go programming language. The goal of the project is to provide a simple, full featured debugging tool for Go. Delve should be easy to invoke and easy to use. Chances are if you’re using a debugger, things aren’t going your way. With that in mind, Delve should stay out of your way as much as possible.

  • Go语言的调试器
  • 目标:提供简单、功能齐全的Go调试工具
  • 容易调用、使用
  • 谁家好的代码天天需要调试呀,尽量少用

如何安装

安装latest,最新版
go install github.com/go-delve/delve/cmd/dlv@latest
如果它报这个错误,证明dlv不支持该平台

go install github.com/go-delve/delve/cmd/dlv@latest
D:\goworkspace\pkg\mod\github.com\go-delve\delve@v1.21.2\service\debugger\debugger.go:32:2: found packages native (dump_other.go) and your_windows_architecture_is_not_supported_by_delve (support_sentinel_windows.go) in D:\goworkspace\pkg\mod\github.com\go-delve\delve@v1.21.2\pkg\proc\native

如何使用

go version
go version go1.20 linux/arm64dlv version
Delve Debugger
Version: 1.21.2
Build: $Id: 98f8ab2662d926245917ade2f2bb38277315c7fc $

你说啥?不会用?我也不会

不会用就看看help吧。dlv --help

Delve is a source level debugger for Go programs.Delve enables you to interact with your program by controlling the execution of the process,
evaluating variables, and providing information of thread / goroutine state, CPU register state and more.The goal of this tool is to provide a simple yet powerful interface for debugging Go programs.Pass flags to the program you are debugging using `--`, for example:`dlv exec ./hello -- server --config conf/config.toml`Usage:dlv [command]Available Commands:attach      Attach to running process and begin debugging.connect     Connect to a headless debug server with a terminal client.core        Examine a core dump.dap         Starts a headless TCP server communicating via Debug Adaptor Protocol (DAP).debug       Compile and begin debugging main package in current directory, or the package specified.exec        Execute a precompiled binary, and begin a debug session.help        Help about any commandtest        Compile test binary and begin debugging program.trace       Compile and begin tracing program.version     Prints version.Additional help topics:dlv backend  Help about the --backend flag.dlv log      Help about logging flags.dlv redirect Help about file redirection.Use "dlv [command] --help" for more information about a command.

汇总一下

命令名作用
attachAttach to running process and begin debugging (白话:跟某个进程建立联系,跟某个进程搞搞暧昧呗)
connectConnect to a headless debug server with a terminal client.(白话:作为一个客户端,连接到一个(无头?不可描述的)调试服务)
coreExamine a core dump. (白话:检查核心转储)
dapStarts a headless TCP server communicating via Debug Adaptor Protocol (DAP). (白话:启一个服务,让客户端连接调试)
debugCompile and begin debugging main package in current directory, or the package specified. (白话:编译并开始调试在当前目录的main包,或者其他给定的包)
execExecute a precompiled binary, and begin a debug session. (白话:执行一个预编译好的二进制文件,并开启一个调试会话)
helpHelp about any command (它会帮你哦,别的可以不会,这个必须会)
testCompile test binary and begin debugging program. (编译测试二进制、并开始调试程序)
traceCompile and begin tracing program. (追踪模式)
versionPrints version. (版本信息啦)

总结一下,上述命令中,如下5个用的多一点儿:

  • attach
  • debug
  • exec
  • core
  • help

其他的看看帮助命令就好
使用dlv help 子命令可查看子命令的帮助文档哈

另外还有如下不常用的命令,暂不做介绍

Additional help topics:dlv backend  Help about the --backend flag.dlv log      Help about logging flags.dlv redirect Help about file redirection.

子命令的具体用法

搞一个先决条件,创建一个main.go文件,写一段简单的代码进去。
就以如下代码为例,main函数中写了一个简易版的httpServer,80端口开放,访问 “http://localhost:80/” 路径,则执行一次斐波那契数列的函数。

package mainimport "net/http"func main() {http.HandleFunc("/", func(writer http.ResponseWriter, request *http.Request) {fib(3)})if err := http.ListenAndServe(":80", nil); err != nil {panic(err)}
}func fib(n int) int {if n < 2 {return 1}return fib(n-1) + fib(n-2)
}

下面对调试命令进行梳理

1. attach

dlv help attach

Attach to an already running process and begin debugging it.This command will cause Delve to take control of an already running process, and
begin a new debug session.  When exiting the debug session you will have the
option to let the process continue or kill it.Usage:dlv attach pid [executable] [flags]Flags:--continue                 Continue the debugged process on start.-h, --help                     help for attach--waitfor string           Wait for a process with a name beginning with this prefix--waitfor-duration float   Total time to wait for a process--waitfor-interval float   Interval between checks of the process list, in millisecond (default 1)Global Flags:--accept-multiclient               Allows a headless server to accept multiple client connections via JSON-RPC or DAP.--allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr--api-version int                  Selects JSON-RPC API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)--backend string                   Backend selection (see 'dlv help backend'). (default "default")--check-go-version                 Exits if the version of Go in use is not compatible (too old or too new) with the version of Delve. (default true)--headless                         Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP client connections.--init string                      Init file, executed by the terminal client.-l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")--log                              Enable debugging server logging.--log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').--log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')--only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)

该命令主要部分: dlv attach pid,该pid是一个Go程序的pid

  1. go build ./main.go

  2. 生成了 main 可执行文件

  3. 使用nohub ./main 或者 setsid ./main 启动 main 文件,此时该文件加载进内存后对应一个进程ID。

  4. 这里使用ps -ef | grep main 找到程序的pid

  5. 使用dlv attach PID 进行调试
    在这里插入图片描述

  6. 输入help 看一下帮助命令

root@Ophelia:~/test# dlv attach 1680
Type 'help' for list of commands.
(dlv) help
The following commands are available:Running the program:call ------------------------ Resumes process, injecting a function call (EXPERIMENTAL!!!)continue (alias: c) --------- Run until breakpoint or program termination.next (alias: n) ------------- Step over to next source line.rebuild --------------------- Rebuild the target executable and restarts it. It does not work if the executable was not built by delve.restart (alias: r) ---------- Restart process.step (alias: s) ------------- Single step through program.step-instruction (alias: si)  Single step a single cpu instruction.stepout (alias: so) --------- Step out of the current function.Manipulating breakpoints:break (alias: b) ------- Sets a breakpoint.breakpoints (alias: bp)  Print out info for active breakpoints.clear ------------------ Deletes breakpoint.clearall --------------- Deletes multiple breakpoints.condition (alias: cond)  Set breakpoint condition.on --------------------- Executes a command when a breakpoint is hit.toggle ----------------- Toggles on or off a breakpoint.trace (alias: t) ------- Set tracepoint.watch ------------------ Set watchpoint.Viewing program variables and memory:args ----------------- Print function arguments.display -------------- Print value of an expression every time the program stops.examinemem (alias: x)  Examine raw memory at the given address.locals --------------- Print local variables.print (alias: p) ----- Evaluate an expression.regs ----------------- Print contents of CPU registers.set ------------------ Changes the value of a variable.vars ----------------- Print package variables.whatis --------------- Prints type of an expression.Listing and switching between threads and goroutines:goroutine (alias: gr) -- Shows or changes current goroutinegoroutines (alias: grs)  List program goroutines.thread (alias: tr) ----- Switch to the specified thread.threads ---------------- Print out info for every traced thread.Viewing the call stack and selecting frames:deferred --------- Executes command in the context of a deferred call.down ------------- Move the current frame down.frame ------------ Set the current frame, or execute command on a different frame.stack (alias: bt)  Print stack trace.up --------------- Move the current frame up.Other commands:config --------------------- Changes configuration parameters.disassemble (alias: disass)  Disassembler.dump ----------------------- Creates a core dump from the current process stateedit (alias: ed) ----------- Open where you are in $DELVE_EDITOR or $EDITORexit (alias: quit | q) ----- Exit the debugger.funcs ---------------------- Print list of functions.help (alias: h) ------------ Prints the help message.libraries ------------------ List loaded dynamic librarieslist (alias: ls | l) ------- Show source code.packages ------------------- Print list of packages.source --------------------- Executes a file containing a list of delve commandssources -------------------- Print list of source files.target --------------------- Manages child process debugging.transcript ----------------- Appends command output to a file.types ---------------------- Print list of typesType help followed by a command for full documentation.
(dlv)

可以看见子命令非常之多

如下汇总一下子命令

执行程序

序号子命令别名描述
01callResumes process, injecting a function call (EXPERIMENTAL!!!) (实验性的功能,注入一个函数调用,重新执行)
02continuecRun until breakpoint or program termination. (执行到断点或程序中止)
03nextnStep over to next source line. (步过下一行,下一行若是函数,则调用并返回)
04rebuildRebuild the target executable and restarts it. It does not work if the executable was not built by delve. (重新编译目标执行文件并启动他, 若该程序不是由delve编译的,则无法执行)
05restartrRestart process. (重启进程)
06stepsSingle step through program. (单步调试,整个程序)
07step-instructionsiSingle step a single cpu instruction. (单步执行cpu指令)
08stepoutosStep out of the current function. (步出当前函数)

操纵断点

序号子命令别名描述
01breakbSets a breakpoint. (设置一个断点)
02breakpointsbpPrint out info for active breakpoints. (打印正在使用的断点)
03clearDeletes brekpoint. (根据断点编号,删除断点)
04clearallDeletes multiple breakpoints.(删除多个断点)
05conditioncondSet breakpoint condition. (设置断点条件)
06onExecutes a command when a breakpoint is hit. (当断点命中时候,执行一个命令)
07toggleToggles on or off a breakpoint. (切换断点的状态,启用或关闭)
08tracetSet tracepoint. (设置追踪点)
09watchSet watchpoint. (设置内存观测点,看门狗的功能)

查看程序变量和内存

序号子命令别名描述
01argsPrint function arguments. (打印函数参数)
02displayPrint value of an expression every time the program stops. (打印表达式的值,在下一行或者下一个断点)
03examinememxExamine raw memory at the given address.(检查给定地址的原始内存)
04localsPrint local variables. (打印局部变量)
05printpEvaluate an expression. (计算并打印表达式结果)
06regsPrint contents of CPU registers.(打印CPU 寄存器的内容)
07setChanges the value of a variable. (给变量设置值)
08varsPrint package variables. (打印包级别变量)
09whatisPrints type of an expression. (打印表达式类型)

进程、协程

序号子命令别名描述
01goroutinegrShows or changes current goroutine. (显示或切换当前协程)
02goroutinesgrsList program goroutines. (列出当前程序所有的协程)
03threadtrSwitch to the specified thread. (切换到指定的线程)
04threadsPrint out info for every traced thread.(打印所有线程的追踪信息)

调用栈、栈帧

序号子命令别名描述
01deferredExecutes command in the context of a deferred call. (在defer调用的上下文中执行一个命令)
01downMove the current frame down. (向下移动栈帧)
03frameSet the current frame, or execute command on a different frame. (设置当前栈帧、或在其他栈帧执行命令)
04stackbtPrint stack trace. (打印栈追踪信息)
05upMove the current frame up. (向上移动当前栈帧)

其他命令

序号子命令别名描述
01configChanges configuration parameters. (修改配置参数)
02disassembledisassDisassembler. (反汇编)
03dumpCreates a core dump from the current process state. (创建核心转储)
04edited
05exitquit、qExit the debugger. (退出调试器)
06funcsPrint list of functions.(打印所有函数)
07helphPrints the help message. (打印帮助信息)
08librariesList loaded dynamic libraries. (列出动态链接库)
09listls 、lShow source code. (打印源码)
10packagesPrint list of packages.(打印包列表)
11sourceExecutes a file containing a list of delve commands. (执行一个包含delve命令列表的文件)
12sourcesPrint list of source files. (打印源码路径列表)
13targetManages child process debugging. (管理子进程调试)
14transcriptappends command output to a file. (追加命令输出到一个文件)
15typesPrint list of types.(打印类型列表)

以上高亮的子命令用的多一些
打一套组合拳(啊打!)
设置断点的方式

break 包名.函数名
b 包名.函数名
break 文件名:行号
b 文件名行号
b main.main
b main.fib
c
n

其他终端: curl http://localhost:80
在这里插入图片描述

描述过于诡异

bp,查看一下断点
在这里插入图片描述clear 1,删除一个断点,并再次查看断点
在这里插入图片描述c,此时断住不动了,怎么办,怎么办?
curl http://localhost:80 当然是在其他终端输入这个啦
在这里插入图片描述此时你会发现,其他终端中卡住了
此时你需要在当前终端一直

c
c
...

c下去,直到把fib函数执行完,再次断住
此时另一个终端中有结果了哦

curl http://localhost:80
StatusCode        : 200
StatusDescription : OK
Content           : {}
RawContent        : HTTP/1.1 200 OKContent-Length: 0Date: Fri, 15 Dec 2023 15:44:06 GMT
Headers           : {[Content-Length, 0], [Date, Fri, 15 Dec 2023 15:44:06 GMT]}
RawContentLength  : 0

其他命令自行探索

2. debug

dlv debug ./main.go
命令参考 attach

3. exec

dlv exec ./main
命令参考 attach

Reference
https://github.com/go-delve/delve

这篇关于Go delve调试工具的简单应用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/514802

相关文章

JavaScript中的高级调试方法全攻略指南

《JavaScript中的高级调试方法全攻略指南》什么是高级JavaScript调试技巧,它比console.log有何优势,如何使用断点调试定位问题,通过本文,我们将深入解答这些问题,带您从理论到实... 目录观点与案例结合观点1观点2观点3观点4观点5高级调试技巧详解实战案例断点调试:定位变量错误性能分

PHP应用中处理限流和API节流的最佳实践

《PHP应用中处理限流和API节流的最佳实践》限流和API节流对于确保Web应用程序的可靠性、安全性和可扩展性至关重要,本文将详细介绍PHP应用中处理限流和API节流的最佳实践,下面就来和小编一起学习... 目录限流的重要性在 php 中实施限流的最佳实践使用集中式存储进行状态管理(如 Redis)采用滑动

深入浅出Spring中的@Autowired自动注入的工作原理及实践应用

《深入浅出Spring中的@Autowired自动注入的工作原理及实践应用》在Spring框架的学习旅程中,@Autowired无疑是一个高频出现却又让初学者头疼的注解,它看似简单,却蕴含着Sprin... 目录深入浅出Spring中的@Autowired:自动注入的奥秘什么是依赖注入?@Autowired

Python 基于http.server模块实现简单http服务的代码举例

《Python基于http.server模块实现简单http服务的代码举例》Pythonhttp.server模块通过继承BaseHTTPRequestHandler处理HTTP请求,使用Threa... 目录测试环境代码实现相关介绍模块简介类及相关函数简介参考链接测试环境win11专业版python

GO语言短变量声明的实现示例

《GO语言短变量声明的实现示例》在Go语言中,短变量声明是一种简洁的变量声明方式,使用:=运算符,可以自动推断变量类型,下面就来具体介绍一下如何使用,感兴趣的可以了解一下... 目录基本语法功能特点与var的区别适用场景注意事项基本语法variableName := value功能特点1、自动类型推

GO语言中函数命名返回值的使用

《GO语言中函数命名返回值的使用》在Go语言中,函数可以为其返回值指定名称,这被称为命名返回值或命名返回参数,这种特性可以使代码更清晰,特别是在返回多个值时,感兴趣的可以了解一下... 目录基本语法函数命名返回特点代码示例命名特点基本语法func functionName(parameters) (nam

Python实战之SEO优化自动化工具开发指南

《Python实战之SEO优化自动化工具开发指南》在数字化营销时代,搜索引擎优化(SEO)已成为网站获取流量的重要手段,本文将带您使用Python开发一套完整的SEO自动化工具,需要的可以了解下... 目录前言项目概述技术栈选择核心模块实现1. 关键词研究模块2. 网站技术seo检测模块3. 内容优化分析模

Go之errors.New和fmt.Errorf 的区别小结

《Go之errors.New和fmt.Errorf的区别小结》本文主要介绍了Go之errors.New和fmt.Errorf的区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考... 目录error的基本用法1. 获取错误信息2. 在条件判断中使用基本区别1.函数签名2.使用场景详细对

PostgreSQL简介及实战应用

《PostgreSQL简介及实战应用》PostgreSQL是一种功能强大的开源关系型数据库管理系统,以其稳定性、高性能、扩展性和复杂查询能力在众多项目中得到广泛应用,本文将从基础概念讲起,逐步深入到高... 目录前言1. PostgreSQL基础1.1 PostgreSQL简介1.2 基础语法1.3 数据库

Go语言连接MySQL数据库执行基本的增删改查

《Go语言连接MySQL数据库执行基本的增删改查》在后端开发中,MySQL是最常用的关系型数据库之一,本文主要为大家详细介绍了如何使用Go连接MySQL数据库并执行基本的增删改查吧... 目录Go语言连接mysql数据库准备工作安装 MySQL 驱动代码实现运行结果注意事项Go语言执行基本的增删改查准备工作