dlv命令详解 - 元素码农

发布时间: 2025-04-08 11:46

↑

# dlv命令详解

本文将详细介绍dlv调试器的各种命令，包括它们的用法、参数选项以及实际应用场景。

## 核心命令

### break (b)
设置断点的命令。

```bash
# 基本语法
break [位置]

# 常见用法
b main.main                 # 在main函数处设置断点
b file.go:23               # 在指定文件的第23行设置断点
b +2                       # 在当前行后的第2行设置断点
b mypackage.MyFunction     # 在特定函数处设置断点
b runtime.panic            # 在panic发生时断点
```

### condition (cond)
为断点设置条件。

```bash
# 基本语法
condition <断点号> <表达式>

# 示例
condition 1 i > 100        # 当i大于100时触发断点1
condition 2 len(slice) == 0 # 当切片为空时触发断点2
```

### continue (c)
继续执行程序直到遇到下一个断点。

```bash
# 基本用法
continue
c          # 简写形式
```

### restart (r)
重新运行程序的命令。

```bash
# 基本语法
restart [参数]

# 常见用法
r                  # 简单重启程序
r --arg1 val1      # 使用新的参数重启程序
r --               # 不带任何参数重启
```

这个命令在以下场景特别有用：
- 修改代码后需要重新运行程序
- 需要使用不同的参数重新测试
- 想要重现某个问题时

### next (n)
执行下一行代码，不进入函数内部。

```bash
# 基本用法
next
n         # 简写形式
n 3       # 执行接下来的3行
```

### step (s)
单步执行，会进入函数内部。

```bash
# 基本用法
step
s         # 简写形式
s 2       # 执行2个步骤
```

### stepout
执行直到当前函数返回。

```bash
# 基本用法
stepout
```

## 信息查看命令

### print (p)
打印变量或表达式的值。

```bash
# 基本语法
print <表达式>

# 常见用法
p variable           # 打印变量值
p *pointer          # 打印指针指向的值
p slice[1:3]        # 打印切片的部分内容
p struct.field      # 打印结构体字段
```

### locals
显示所有局部变量。

```bash
# 基本用法
locals
```

### args
显示函数参数。

```bash
# 基本用法
args
```

### stack
显示调用栈信息。

```bash
# 基本语法
stack [<深度>] [<goroutine号>]

# 示例
stack       # 显示当前goroutine的完整调用栈
stack 3     # 显示前3层调用栈
stack -full # 显示包含局部变量的完整调用栈
```

### whatis
显示表达式的类型信息。

```bash
# 基本语法
whatis <表达式>

# 示例
whatis v        # 显示变量v的类型
whatis []int    # 显示类型的详细信息
```

## Goroutine相关命令

### goroutines
列出所有goroutine。

```bash
# 基本用法
goroutines
```

### goroutine
切换或显示当前goroutine信息。

```bash
# 基本语法
goroutine [<id>] [-force]

# 示例
goroutine 12      # 切换到goroutine 12
goroutine         # 显示当前goroutine信息
```

## 变量监视命令

### watch
设置变量监视点。

```bash
# 基本语法
watch <表达式>

# 示例
watch x           # 监视变量x的值变化
watch *p         # 监视指针p指向的值的变化
```

### display
设置每次停止时显示的表达式。

```bash
# 基本语法
display <表达式>

# 示例
display i        # 每次停止时显示i的值
display len(s)   # 每次停止时显示s的长度
```

## 源码查看命令

### list (ls)
显示源代码。

```bash
# 基本语法
list [<位置>]

# 示例
list             # 显示当前位置周围的代码
list main.main   # 显示main函数的代码
list +10         # 显示向后10行代码
```

## 高级命令

### trace
设置跟踪点。

```bash
# 基本语法
trace [<位置>] [<条件>]

# 示例
trace foo              # 跟踪foo函数的进入和退出
trace runtime.panic    # 跟踪panic的发生
trace -p goroutine     # 跟踪goroutine的创建和完成
trace "pkg.*"          # 跟踪包内所有函数调用
```

### examinemem
检查内存内容。

```bash
# 基本语法
examinemem <地址> <长度>

# 示例
examinemem 0xc000096000 32    # 查看指定地址的32字节内存
examinemem &v 16             # 查看变量v所在内存区域
```

### profile
收集性能分析数据。

```bash
# CPU分析
profile cpu

# 内存分析
profile mem

# goroutine分析
profile goroutine

# 阻塞分析
profile block
```

### disassemble
查看汇编代码。

```bash
# 基本语法
disassemble [<位置>]

# 示例
disassemble main.main    # 查看main函数的汇编代码
disassemble              # 查看当前位置的汇编代码
disassemble +0x1c        # 查看指定偏移量的汇编代码
```

### on
在断点处执行命令。

```bash
# 基本语法
on <断点号> <命令>

# 示例
on 1 print i           # 在断点1处打印i的值
on 2 stack             # 在断点2处显示调用栈
```

### config
修改调试器配置。

```bash
# 基本语法
config -list           # 列出所有配置
config -set <选项>=<值> # 设置配置项

# 常用配置
config -set max-string-len=1000 # 设置字符串显示长度
config -set max-array-values=100 # 设置数组显示元素数量
```

## 实用技巧

### 条件断点与数据断点结合

```bash
# 在值变化时中断
b main.process
condition 1 oldValue != newValue

# 在特定条件下中断
b runtime.panic
condition 1 strings.Contains(err.Error(), "specific error")
```

### 使用on命令自动化调试

```bash
# 自动记录变量值
b main.process
on 1 print i
on 1 print len(slice)

# 自动检查条件
b main.update
on 2 if value > 100 { print "Warning: value too large" }
```

### 使用函数调用

```bash
# 在调试时调用函数
p strings.Contains(str, "prefix")
p fmt.Sprintf("%d: %s", id, name)
```

## 常见问题解决方案

1. 断点不触发
   ```bash
   # 检查断点状态
   breakpoints
   
   # 清除并重新设置断点
   clear 1
   b main.main
   ```

2. 变量信息不完整
   ```bash
   # 修改显示配置
   config -set max-string-len=1000
   config -set max-array-values=100
   ```

3. 需要临时禁用断点
   ```bash
   # 禁用特定断点
   disable 1
   
   # 重新启用断点
   enable 1
   ```

## 并发调试技巧

### goroutine同步点

```bash
# 等待所有goroutine到达同步点
sync

# 设置goroutine过滤器
goroutine -match "pattern"

# 查看goroutine阻塞原因
goroutine -stack -blocked
```

### 死锁分析

```bash
# 查看持有锁的goroutine
goroutine -locks

# 分析死锁场景
goroutine -deadlock
```

## 内存调试技巧

### 内存泄漏分析

```bash
# 触发GC
gc

# 查看堆对象分配
heap

# 查看特定类型的内存使用
heap -type="TypeName"
```

### 变量作用域分析

```bash
# 查看变量的作用域
scopes

# 查看包级变量
vars package
```

## 调试会话管理

### 保存和恢复调试状态

```bash
# 保存断点配置
save breakpoints bp.json

# 加载断点配置
source bp.json

# 创建调试脚本
script debug.txt
```

### 调试历史记录

```bash
# 查看命令历史
history

# 重复执行上一条命令
replay
```

## 最佳实践

1. 使用条件断点减少手动操作
2. 合理使用on命令自动化调试流程
3. 善用配置命令优化输出格式
4. 创建命令别名简化常用操作
5. 使用goroutine过滤器定位并发问题
6. 结合内存分析工具定位内存泄漏
7. 保存常用调试配置提高效率
8. 使用调试脚本自动化重复操作

## 参考资源

- [Delve命令行文档](https://github.com/go-delve/delve/tree/master/Documentation/cli)
- [Delve API文档](https://pkg.go.dev/github.com/go-delve/delve/service/api)
- [Go调试器文档](https://golang.org/doc/gdb)

通过本文的详细介绍，你应该能够更好地掌握dlv的各种命令用法，并在实际调试中灵活运用这些命令来提高调试效率。记住，熟练使用这些命令需要在实践中不断积累经验。