前言
GDB (GNU Debugger) 是 Linux/Unix 平台上最強大、最通用的原生碼偵錯器。掌握 GDB 核心命令,能讓你在無 IDE 的伺服器環境、嵌入式裝置、Core Dump 事後分析中遊刃有餘。本文系統整理常規偵錯、多執行緒、Core 分析三大場景的高頻命令與實戰技巧。
前置準備:編譯帶偵錯資訊的執行檔
gcc -g -O0 -Wall -o myapp myapp.c # C 程式
g++ -g -O0 -Wall -o myapp myapp.cpp # C++ 程式
# -g:產生 DWARF 偵錯資訊
# -O0:關閉優化,讓行號、變數對應源碼
# 若需釋出版本偵錯:-g -O2(行號可能偏移,變數可能被優化掉)
一、啟動與載入
| 場景 | 命令 | 說明 |
| 啟動偵錯執行檔 | gdb ./myapp | 進入 GDB 互動模式 |
| 帶參數啟動 | gdb --args ./myapp arg1 arg2 | 參數傳遞給被偵錯程式 |
| 偵錯 Core Dump | gdb ./myapp core.12345 | 事後分析崩潰現場 |
| 附加到執行中進程 | gdb -p 12345 或 (gdb) attach 12345 | 需 root 或同 UID |
| 遠端偵錯 | target remote 192.168.1.100:1234 | 配合 gdbserver 使用 |
二、常規偵錯核心命令速查表
源碼瀏覽與編輯
| 命令 | 縮寫 | 功能 | 範例 |
list | l | 顯示源碼(預設 10 行) | l 20、l main、l MyClass::method |
list - | | 向上翻頁 | |
edit | e | 用 $EDITOR 編輯當前行/函數 | e 25、e MyClass::method |
info sources | | 列出已載入源碼檔案 | |
斷點管理
| 命令 | 縮寫 | 功能 | 範例 |
break | b | 設定斷點 | b 30、b main、b MyClass::method、b file.c:45 |
tbreak | | 臨時斷點(命中一次自動刪除) | tbreak 50 |
watch | | 資料觀察點(寫入觸發) | watch ptr->value |
rwatch | | 讀觀察點(讀取觸發) | |
awatch | | 讀/寫觀察點 | |
info breakpoints | i b | 列出所有斷點編號、位置、啟用狀態 | |
disable/enable N | | 禁用/啟用第 N 號斷點 | |
delete N | d N | 刪除第 N 號斷點 | |
condition N expr | | 設定條件斷點 | condition 3 i==100 |
commands N | | 斷點命令列表(自動執行) | commands 1\nprint x\ncontinue\nend |
執行控制
| 命令 | 縮寫 | 功能 | 對應 IDE 快捷鍵 |
run [args] | r | 開始/重新執行程式 | F5 |
continue | c | 繼續執行至下一斷點 | F5 |
next | n | 單步跳過(不進入函數) | F10 |
step | s | 單步進入(進入函數內部) | F11 |
stepi | si | 單步機器指令 | Ctrl+F11 |
nexti | ni | 單步機器指令(跳過 call) | |
finish | | 執行至當前函數返回 | Shift+F11 |
until [loc] | u | 執行至指定行/位置(跳出迴圈神器) | u 50 |
資料檢查與修改
| 命令 | 縮寫 | 功能 | 範例 |
print | p | 列印運算式值 | p x、p *ptr、p/x addr (十六進制)、p/t val (二進制) |
display | disp | 自動顯示(每次停下自動列印) | disp/i $pc 顯示當前指令 |
undisplay N | | 取消自動顯示 | |
whatis | | 查看變數/運算式類型 | whatis my_struct |
ptype | | 詳細類型定義(結構體展開) | ptype struct sockaddr_in |
set var = val | | 修改變數值 | set var x=42、set {int}0x7fff... = 0 |
x/FMT ADDR | | 記憶體檢查 | x/20xw $sp、x/s ptr (字串) |
堆疊與框架
| 命令 | 縮寫 | 功能 |
backtrace | bt | 完整堆疊回溯 |
bt full | | 帶區域變數的完整回溯 |
frame N | f N | 切換到第 N 層框架 |
up/down | | 向上/向下移動框架 |
info frame | i f | 當前框架詳細信息 |
info locals | | 當前框架區域變數 |
info args | | 當前框架函數參數 |
其他實用命令
| 命令 | 縮寫 | 功能 |
help [cmd] | h | 線上幫助 |
quit | q | 退出 GDB |
shell CMD | | 執行 Shell 命令 |
make [target] | | 不離開 GDB 重新編譯(保留斷點) |
source .gdbinit | | 載入自訂腳本 |
set confirm off | | 關閉確認提示(腳本自動化用) |
set pagination off | | 關閉分頁(輸出重導向時必加) |
三、多執行緒偵錯實戰
核心命令
| 命令 | 縮寫 | 功能 |
info threads | i thr | 列出所有可偵錯執行緒(* 為當前) |
thread N | thr N | 切換到第 N 號執行緒 |
thread apply N1 N2 cmd | | 讓指定執行緒執行命令 |
thread apply all cmd | | 讓所有執行緒執行命令 |
set scheduler-locking off|on|step | | 控制單步時其他執行緒行為 |
scheduler-locking 三種模式詳解
| 模式 | 行為 | 適用場景 |
off (預設) | 所有執行緒並發執行 | 一般偵錯、觀察併發 Bug |
on | 僅當前執行緒執行,其他凍結 | 精準單步、避免競態干擾 |
step | 單步時僅當前執行緒執行(next 過函數除外) | 平衡模式,推薦多執行緒偵錯預設 |
實戰範例:死鎖定位
(gdb) info threads
Id Target Id Frame
* 1 Thread 0x7f... (LWP 1234) "main" pthread_mutex_lock () at main.c:45
2 Thread 0x7f... (LWP 1235) "worker" pthread_cond_wait () at worker.c:30
3 Thread 0x7f... (LWP 1236) "worker" pthread_mutex_lock () at worker.c:25
(gdb) thread apply all bt
# 所有執行緒堆疊一次看完,找出互相等待的鎖
(gdb) set scheduler-locking on
(gdb) thread 2
(gdb) bt
# 專注分析執行緒 2 的等待鏈
四、Core Dump 事後分析標準流程
- 啟用 Core Dump:
ulimit -c unlimited # 當前 Shell
echo '/var/crash/core.%e.%p' > /proc/sys/kernel/core_pattern # 系統級(需 root)
- 獲取 Core 文件:程式崩潰後產生
core.PID
- 載入分析:
gdb ./myapp core.12345
(gdb) bt # 直接看崩潰堆疊
(gdb) info registers # 檢查暫存器
(gdb) frame N # 切到可疑框架
(gdb) print var # 檢查關鍵變數
- 自動化分析腳本:
# .gdbinit 或腳本文件
set pagination off
set confirm off
bt
info threads
thread apply all bt
quit
gdb -batch -x analyze.gdb ./myapp core.12345 > crash_report.txt
五、.gdbinit 推薦配置(放入 ~ 或專案根目錄)
# 基礎體驗優化
set confirm off
set pagination off
set history save on
set history size 10000
set print pretty on
set print object on
set print static-members on
set print vtbl on
# 彩色輸出(GDB 10+)
set style enabled on
set style sources current-line "bold underline"
set style sources current-file "yellow"
# 常用別名
define hook-run
echo \n=== Program started ===\n
end
define pvec
# 印 vector 等 STL 容器
set $vec = $arg0
set $size = $vec.size()
set $i = 0
while ($i < $size)
printf "[%d] = %d\n", $i, $vec[$i]
set $i = $i + 1
end
end
document pvec
pvec std::vector &v -- 印出 vector 所有元素
end
六、進階技巧精選
- 反向偵錯 (Reverse Debugging):
record → reverse-next/reverse-continue 回溯時間(需硬體/記憶體支援,GDB 7+)
- Python 腳本化:
python import gdb; gdb.execute('bt') — 編寫複雜分析腳本、自動化測試
- TUI 模式:
gdb -tui 或 Ctrl+X, A 切換 — 終端分屏顯示源碼/彙編/暫存器
- 記憶體檢查工具整合:
valgrind --vgdb=yes --vgdb-error=0 ./app → target remote | vgdb — 在 GDB 中偵錯 Valgrind 報錯點
結語
GDB 命令雖多,但核心高頻集合僅 30 個左右。建議:先熟練單執行緒流程 (b, r, n, s, c, p, bt, f) → 掌握多執行緒切換與 scheduler-locking → 建立 Core Dump 自動分析流程 → 定製 .gdbinit 與 Python 腳本。將 GDB 內化為肌肉記憶,你就能在任何 Linux 環境裡,像在 IDE 裡一樣從容診斷最棘手的崩潰與邏輯 Bug。