Birdseye：極其強(qiáng)大的Python調(diào)試工具

Birdseye是一個Python調(diào)試器，它在函數(shù)調(diào)用中記錄表達(dá)式的值，并讓你在函數(shù)** 退出 **后輕松查看它們，例如：

無論你如何運(yùn)行或編輯代碼，都可以使用Birdseye。只需要你安裝好依賴：

pip install birdseye

并在代碼函數(shù)上方添加 ** @eye ** 裝飾器（如上動圖所示），即可根據(jù)需要運(yùn)行函數(shù)，并在瀏覽器中查看結(jié)果。

它還可以與一些常用工具集成在一起，如 Pycharm 和 Vscode，以提供更流暢的體驗(yàn)，后續(xù)我們會介紹如何將其與這些工具結(jié)合使用。

它不僅僅能夠單步執(zhí)行，還能在 循環(huán)迭代中來回移動 ，并查看所選表達(dá)式的值如何變化：

通過 birdseye 你能很容易地知道哪些表達(dá)式引發(fā)了異常：

你也能夠展開具體的數(shù)據(jù)結(jié)構(gòu)和對象以查看其內(nèi)容:

調(diào)用會按功能組織（文件組織）并進(jìn)行時間排序進(jìn)行顯示，讓你一目了然地看到發(fā)生了什么：

1.快速上手

首先，使用 pip 安裝 birdseye ：

pip install birdseye

然后，對需要進(jìn)行調(diào)試的函數(shù)使用eye裝飾器：

from birdseye import eye

@eye
def foo():

在你調(diào)用該函數(shù)完成后，在終端運(yùn)行命令打開Birdseye的Web服務(wù)：

python -m birdseye

在瀏覽器打開 http://localhost:7777 就能看到需要調(diào)試的函數(shù)執(zhí)行流程了。點(diǎn)擊下圖的按鈕即可跳轉(zhuǎn)到最新的函數(shù)調(diào)用。

2.在Pycharm中集成調(diào)試

在 Pycharm 的 Settings 中，點(diǎn)擊 Plugins 插件市場搜索 birdseye 點(diǎn)擊 install 安裝。

安裝完成后重啟Pycharm，就可以在 Pycharm 中使用 birdseye了：

默認(rèn)情況下，該插件還可以為你自動運(yùn)行Birdseye服務(wù)器，因此就不需要輸入 python -m birdseye 那行命令了。

3.在VSCode中集成調(diào)試

在VSCode中繼承調(diào)試Birdseye也非常方便，點(diǎn)擊左側(cè)的擴(kuò)展商店，在彈出框中輸入搜索 birdseye，并點(diǎn)擊 install 安裝：

安裝完成后，點(diǎn)擊 F1 輸入Birdseye，就能顯示調(diào)試界面：

如果無法正常顯示右側(cè)調(diào)試界面，并提示未安裝birdseye，但實(shí)際上你已經(jīng)安裝成功了，這一般是路徑錯誤導(dǎo)致的，請?jiān)跀U(kuò)展設(shè)置中手動更改python路徑為你安裝了Birdseye的Python。

4.美中不足

Birdseye 是一個非常強(qiáng)大的調(diào)試工具，但我認(rèn)為這還是有缺點(diǎn)可以改善的：

1.為了防止堆棧過大，每個迭代它最多只保留6個(前三、末三)元素：

因此如果你想看一些特殊元素值的執(zhí)行情況，它可能不會如你所愿。

不過，不需要擔(dān)心某些分支你調(diào)試不到，因?yàn)?birdseye 有個保險(xiǎn)機(jī)制： 如果一個表達(dá)式僅在某種特定情況下會被執(zhí)行，那么執(zhí)行時的元素也會被加入到可調(diào)試元素中 。

2.由于需要記錄堆棧，程序會大大減慢速度，因此它絕對不適合上到生產(chǎn)環(huán)境。

3.每個函數(shù)調(diào)用，Birdseye 都需要收集許多數(shù)據(jù)，對于某些極其復(fù)雜的函數(shù)調(diào)用，可能會引發(fā)內(nèi)存問題。