能做什麼
即時追蹤 log 檔的新內容,效果就像在終端機跑 tail -f,但更好讀:依等級自動上色、用關鍵字和等級過濾,常看的檔案留成書籤,切走的檔案在背景繼續追蹤。
打開 log 檔的三種方法
在右上角的輸入框貼上檔案的絕對路徑按 Return、點資料夾圖示選檔,或直接把檔案拖進視窗。輸入框很寬容:從 Finder 拷貝的 file:// 網址、前後的引號、終端機的跳脫空白和 ~ 開頭的路徑都會自動整理好。畫面先顯示檔案最後 2000 行,之後有新的一行寫進來,就自動出現在最下面。
一眼看出重點
log 檔本身沒有顏色,Log 檢視器依每一行的格式自動上色:時間、等級、執行緒、logger 和訊息各有顏色,SQL 的關鍵字、名稱、字串和參數也分開標示。找不到的部分照原樣顯示,不會硬套。
過濾,但不拆散錯誤
「過濾關鍵字」不分大小寫,只顯示含有那段字的行。等級篩選有四個選項:「全部」、「INFO+」(藏起 DEBUG 和 TRACE)、「WARN+」、「ERROR」。沒有等級的行,例如錯誤的呼叫堆疊或接在後面的 SQL,篩選時一律保留,錯誤訊息不會被拆得看不懂。WARNING 視為 WARN,FATAL、SEVERE、ERR 視為 ERROR。
跟隨與暫停
暫停期間新內容照樣在接收,回到跟隨時一次看到。暫停時可以安心用滑鼠跨好幾行選取,或 ⌘A 全選、⌘C 複製出去。
書籤與多個檔案
你打開的新檔案會自動加進最上面的書籤列,名稱是「上層資料夾/檔名」,好幾個專案都叫 app.log 也分得出來。切到別的檔案時,原本那個的內容、過濾、跟隨狀態和捲動位置都會保留,並在背景繼續追蹤;書籤前的綠點代表背景追蹤中,橘字代表檔案不見了。不想讓某個檔案繼續佔記憶體,右鍵「釋放記憶體(停止背景追蹤)」。
怎麼用
- 按「Log 檢視器」快捷鍵叫出視窗,或從功能選單「文字與工具」→「Log 檢視器」打開。
- 在輸入框貼上 log 檔的絕對路徑按 Return,或點資料夾圖示選檔,或把檔案拖進視窗。
- 新的一行寫進來就自動出現在最下面。
- 在「過濾關鍵字」輸入字,或點「INFO+」「WARN+」「ERROR」,只看想看的行。
- 往上捲回去看舊內容時畫面會暫停,看完點「已暫停」回到最下面。
快捷鍵
全域快捷鍵
| 快捷鍵名稱 | 預設 |
|---|---|
| Log 檢視器 | 預設未綁定 |
在任何 App 裡都能按。想換組合,到「設定」→「快捷鍵」點一下錄製欄,按下新的組合。
視窗裡的按鍵
| 按鍵 | 動作 |
|---|---|
| Return | 在路徑輸入框裡,打開貼上的檔案。 |
| ⌘A | 全選目前顯示的內容。 |
| ⌘C | 複製選取的行。 |
相關設定
「設定」→「工具箱」
- Log 檢視器
- 錄製快捷鍵,預設未綁定。
視窗裡
- 書籤
- 打開過的檔案自動加入,右鍵可以「在 Finder 中顯示」或「移除書籤」。
- 字級
- 滑桿調 9 到 20,所有檔案共用。
- 清畫面
- 只清掉視窗裡目前的內容,log 檔本身不會被動到。
書籤、字級和上次開啟的檔案都會自動記住,下次叫出時自動打開上次看的檔案。
需要的權限
不需要額外權限。Log 檢視器只讀取你打開的檔案,不會修改它。
小技巧
- 按「清畫面」後只看「從現在開始」的輸出,方便重現問題時對照。
- 狀態列的「8 / 2000 行」表示符合條件的有 8 行、目前讀進來的共 2000 行。
- 狀態列的「保留 2/5」表示有 2 個檔案留在記憶體裡,上限是 5 個。
- 檔案被移走後書籤變成橘字,滑鼠移上去會顯示原本的路徑。
- 視窗在最前面時再按一次快捷鍵就收起,被別的視窗蓋住時會先叫到前面。