Skip to Content

診斷

出問題時先看這裡:Git 實際執行了什麼、配置從哪來、倉庫有沒有結構性問題。

Git 輸出

開啟「Git 輸出」檢視本次會話裡執行過的每條 Git 命令與輸出,支援過濾。

  • 命令按執行順序追加,失敗的命令帶退出資訊;
  • 長輸出會截斷顯示;
  • 從錯誤橫幅、認證提示與狀態列都能直接跳到這個面板。

應用不隱藏 Git 的行為。同樣的命令在終端裡可以復現。

Git 配置

「Git 配置」列出當前生效的配置項與來源,可搜尋。它讀取的是 git config 的結果,不修改任何值。

配置裡可能包含本地路徑、使用者名稱或遠端地址。貼給別人之前請先檢查。

倉庫健康檢查

對當前倉庫做一次只讀掃描,八項檢查:

檢查內容
物件完整性git fsck 報告的問題
物件儲存鬆散物件數量與可清理的打包垃圾
大物件至少 1 MiB 的物件
已合併分支已合併到 HEAD 的本地分支
遠端跟蹤引用遠端已不存在的分支對應的引用
克隆方式淺克隆或部分克隆
Git LFS是否安裝 git-lfs、是否有仍是佔位指標的檔案
未跟蹤檔案至少 1 MiB 的未跟蹤檔案

掃描本身不執行任何修改,可以取消;掃描時間與結果都會標明,過期後提示重新掃描。報告可以複製成文本。

檢查結果旁邊會給出對應動作,例如最佳化(gc)、重跑 fsck、清理遠端跟蹤引用、刪除已合併分支、拉取 LFS 物件。這些動作都會先確認,刪除類操作會寫恢復快照。

診斷包

「幫助 → 匯出診斷包…」把你選擇位置的一個 zip 打包出來,內容包括:

  • 輪轉的日誌檔案;
  • panic.log;
  • 系統資訊快照;
  • 脫敏後的設定;
  • 一份說明檔案。

診斷包不包含 diff 正文、提交內容、倉庫檔案或憑據。發給我們之前仍建議自己看一眼。

日誌

應用把結構化日誌寫成 JSON Lines,按大小與數量輪轉,引數在「設定 → 高階 → 日誌」。

  • 級別預設 info,可調到 debug;
  • 單檔案上限與保留檔案數可調;
  • 「日誌」頁列出日誌檔案,可過濾、複製與開啟所在目錄。

日誌不會記錄 diff 正文、倉庫檔案內容、憑據或 AI 提示中的路徑。

崩潰記錄

  • 未捕獲的執行時崩潰寫入 panic.log;
  • 後臺任務的 panic 會被恢復並帶堆疊寫入日誌,不會讓應用直接退出;
  • 上次會話異常結束時留下的鎖檔案會在下次啟動標記,方便定位。

日誌與資料目錄的路徑見設定的「高階」分割槽。

最後更新於