Golang /Go調試工具delve

原文地址:https://github.com/derekparker/delve/tree/master/Documentation

安裝

這里提供了支持的所有平臺(操作系統)上安裝Delve的說明。 請注意您必須安裝Go 1.5或更高版本。 此外如果使用Go 1.5,您必須設置GO15VENDOREXPERIMENT = 1,然后再嘗試安裝。

  • OSX
在OSX上插入

請使用以下步驟在OSX上構建和安裝Delve

Via Homebrew

如果你安裝了HomeBrew,只需運行:

$ brew install go-delve/delve/delve

手動安裝

0) 必備條件
確保您具有正確的編譯工具鏈。
這應該是簡單的:

xcode-select --install

1)創建自簽名證書
你必須創建自簽名證書,并使用它簽署二進制文件:

  1. 打開應用程序“鑰匙串訪問”(/ Applications / Utilities / Keychain Access.app)
  2. 打開菜單 /Keychain Access/Certificate Assistant/Create a Certificate...
  3. 選擇一個名稱(在示例中為dlv-cert),將“Identity Type(身份類型)”設置為“Self Signed Root(自簽名根)”,將“Certificate Type(證書類型)”設置為“Code Signing(代碼簽名)”,然后選擇“Let me override defaults(讓我覆蓋默認值)”。 單擊“Continue(繼續)”。 您可能想將預定義的365天期間延長到3650天。
  4. 單擊“Continue(繼續)”多次,直到進入“Specify a Location For The Certificate(指定證書的位置)”頁面,然后將“Keychain to System(鑰匙串設置為系統)”。
  5. 如果您不能將證書存儲在“System(系統)”鑰匙扣中,請在“login(登錄)”鑰匙扣中創建,然后將其導出。 然后,您可以將其導入到“System(系統)”鑰匙扣。
  6. 在鑰匙串中選擇“系統”,你應該找到你的新證書。 使用證書的上下文菜單(不是公鑰或私鑰),選擇“獲取信息”,打開“信任”項,并將“代碼簽名”設置為“始終信任”。
  7. [至少在Yosemite上:]在鑰匙串中選擇類別Keys - > dlv-cert - >右鍵單擊 - > GetInfo - >Access Control (訪問控制) - >選擇“允許所有應用程序訪問此項目” - >保存更改。
  8. 您必須退出“鑰匙串訪問”應用程序,才能使用證書并通過終止當前運行的“任務門”進程重新啟動“任務門”服務。 或者,您可以重新啟動計算機。
    2)二進制安裝
  9. 在寫go程序的時候首先創建文件夾$GOPATH/src/github.com/derekparker 并且cd 到c$GOPATH/src/github.com/derekparker目錄下
  10. clone 這個項目:git clone https://github.com/derekparker/delve.git 并且cd delve

注意:如果您使用Go 1.5必須先設置GO15VENDOREXPERIMENT = 1,然后才能繼續安裝。
GO15VENDOREXPERIMENT env var只是選擇進入Go 1.5 Vendor Experiment。(1.6不需要)

所有make命令都假設一個CERT環境變量,其中包含上面創建的證書的名稱。 Makefile還假定GOPATH是單值的,不是冒號分隔的。 makefile只需要幫助促進構建和代碼簽名的過程。

說明

在構建期間取消代碼簽名授權提示
如果在使用自簽名證書運行make時提示您授權,請嘗試以下操作:

  • 打開應用程序“鑰匙串訪問”(/ Applications / Utilities / Keychain Access.app)
  • 雙擊與您的自簽名證書(示例中的dlv-cert)對應的私鑰
  • 選擇“Access Control(訪問控制)”選項卡
  • 單擊“始終允許這些應用程序訪問”下的[+],然后從Finder對話框中選擇/ usr / bin / codesign
  • 點擊“(Save changes)保存更改”按鈕
  • 消除“Developer tools access(開發工具訪問)”提示運行delve

如果運行dlv時出現此提示:

"Developer tools access needs to take control of another process for debugging to continue. Type your password to allow this"

嘗試運行DevToolsSecurity -enable以消除提示。 有關更多信息,請參閱man DevToolsSecurity。

  • Linux
    請使用以下步驟在Linux上構建和安裝Delve
    在Linux上有兩種安裝方式。 首先是標準的go get方法:

go get github.com/derekparker/delve/cmd/dlv

或者,您可以克隆repo并運行:

$ make install

注意:如果您使用Go 1.5必須先設置GO15VENDOREXPERIMENT = 1,然后才能繼續安裝。 GO15VENDOREXPERIMENT env var只是選擇進入Go 1.5 Vendor Experiment

  • Windows
    請使用標準的go get命令在Windows上構建和安裝Delve

go get github.com/derekparker/delve/cmd/dlv

注意:如果您使用Go 1.5必須先設置GO15VENDOREXPERIMENT = 1,然后才能繼續安裝。 GO15VENDOREXPERIMENT env var只是選擇進入Go 1.5 Vendor Experiment

用法

您可以多種方式調用Delve,具體取決于您的使用需求。 Delve使每個嘗試都是用戶友好的,確保用戶必須做最少的工作可能開始調試他們的程序。

請參閱主要使用文檔以進一步探索命令。

命令行界面

命令

命令 描述
args 打印函數參數
break 設置一個斷點
breakpoints 打印激活的斷點信息
clear 刪除斷點
clearall 刪除所有的斷點
condition 設置斷點條件
continue 運行到斷點或程序終止
disassemble 拆解器
exit 退出debugger
frame 在不同的框架上執行的命令
funcs 打印函數列表
goroutine 顯示或更改當前goroutine
goroutines 列出程序的全部goroutines
help 打印出幫助信息
list 顯示源代碼
locals 打印局部變量
next 跳到下一行
on 在遇到斷點時執行一個命令
print 評估表達式
regs 打印CPU寄存器的內容
restart 重啟進程
set 更改變量的值
source 執行包含delve命令列表的文件
sources 打印源文件列表
stack 打印堆棧跟蹤
step 單步執行程序
step-instruction 單步單個執行cpu指令
thread 切換到指定的線程
threads 打印每一個跟蹤線程的信息
trace 設置跟蹤點
types 打印類型列表
vars 打印某個包內的(全局)變量

API

API文檔

Delve公開了主要可以與Delve編程交互的IDEs和編輯器的一個API接口,以便這些程序使用。 API由終端使用,因此無論新功能如何,都將始終保持最新的鎖定狀態。

使用

為了在“API模式”中運行Delve,只需使用標準命令之一調用,提供--headless標志,如下所示:

$ dlv debug --headless --api-version=2 --log --listen=127.0.0.1:8181

這將以非交互模式啟動調試器,偵聽指定的地址,并啟用日志記錄。 當然最后兩個標志(log listen)是可選的。
或者如果您要將多個客戶端連接到API,也可以指定--accept-multi客戶端標志。
您可以使用connect子命令從Delve本身連接headless調試器:

$ dlv connect 127.0.0.1:8181

這對于遠程調試很有用。

API 接口

Delve已經可以允許多個客戶端/服務器這種方式的架構。因為所有的“業務邏輯”被抽象出實際的客戶端/服務器實現,所有允許容易實現新的API接口。

當前API接口

JSON-RPC

內部文件

TODO(derek parker)

將要做的

這個目錄將包含調試器內部和它如何工作的文檔。

編輯器集成

可以使用以下用于delve編輯器的插件:
1. Golang Plugin for IntelliJ IDEAhttps://github.com/go-lang-plugin-org/go-lang-idea-plugin
2. Go for Visual Studio Code (https://github.com/Microsoft/vscode-go#go-for-visual-studio-code)
3. Emacs plugin https://github.com/benma/go-dlv.el/
4. LiteIDE https://github.com/visualfc/liteide
5. Go Debugger for Atom
go-debug
atom 使用delve 來調試代碼

demo.gif

安裝
可以使用apm install go-debug或在設置中搜索go-debug。
安裝delve
查閱https://github.com/derekparker/delve/tree/master/Documentation/installation
綁定的快捷鍵

f5 運行當前包 (dlv debug)
ctrl-f5 測試運行當前包(dlv test)
shift-f5 重新啟動當前的delve會話(r / restart)
f6 停止delve (exit / quit / q)
f8 繼續執行 (c / continue)
f9 切換斷點
f10 到下一個斷電源(n / next)
f11 進入函數 (s / step)
cmd-k cmd-g (mac) / ctrl-k ctrl-g (others) 切換主面板

鏈接
關于slack的golang社區:Gopher Slack| go-plus
問題?請直接在go-plus頻道給我發送消息

已知bugs

  • 當一個函數定義兩個(或多個)同名的變量時,delve無法區分它們:locals將打印這兩個變量,print將隨機選擇一個。 參見問題Issue#106
  • Delve目前不支持32位系統。 這通常表現為proc / disasm.go中的編譯器錯誤。 參見問題Issue#20
  • 當Delve使用go之前的版本1.7.0編譯時,不能使用Receiver.Method Name語法在遠程包中的函數上設置斷點。 參見問題Issue#528
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,565評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,115評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,577評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,514評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,234評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,621評論 1 326
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,641評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,822評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,380評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,128評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,319評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,879評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,548評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,970評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,229評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,048評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,285評論 2 376

推薦閱讀更多精彩內容