排解原始碼控制問題

本文旨在協助您透過輸出記錄檔與追蹤記錄，診斷並解決 Visual Studio Code 中的 Git 問題。當 Git 操作失敗或表現異常時，請使用這些診斷工具。

Git 輸出視窗

VS Code 會使用您電腦上安裝的 Git 來執行原始碼控制操作。Git 輸出視窗提供了 VS Code 所執行 Git 指令的詳細記錄。這些資訊有助於了解目前正在執行哪些 Git 操作，並協助診斷問題。

若要開啟 Git 輸出視窗：

• 在「原始碼控制」檢視中，選取 ... 選單，然後選擇 顯示 Git 輸出 (Show Git Output)

• 從命令面板執行 Git: 顯示 Git 輸出 (Git: Show Git Output) 指令（⇧⌘P (Windows, Linux Ctrl+Shift+P)）

• 開啟 輸出 (Output) 面板（⇧⌘U (Windows Ctrl+Shift+U, Linux Ctrl+K Ctrl+H)），並從下拉式選單中選擇 Git

Git 輸出視窗會顯示：

• Git 延伸模組目前的記錄層級
• 所使用的 Git 執行檔路徑
• 由 VS Code 執行的 Git 指令
• 指令錯誤訊息
• 每個指令的時間戳記與執行持續時間

當 Git 操作失敗或表現異常時，請查看此輸出內容。這些資訊有助於識別 Git 設定、驗證或儲存庫狀態相關的問題。

篩選與搜尋 Git 記錄檔

Git 輸出視窗可能會產生大量資訊。若要有效率地找到相關項目，可以使用以下技巧：

• 利用輸出面板中的下拉式選單，按記錄層級或記錄類別篩選輸出內容

  

  記錄層級包括：trace (追蹤)、debug (偵錯)、info (資訊)、warning (警告)、error (錯誤)。預設情況下，Git 輸出視窗會顯示 info 層級及以上的內容。

  記錄類別會根據記錄的內容而變動，例如 git 或 repository。若要查看目前執行的 Git 指令，請選取 git 類別。

• 使用輸出面板中的搜尋框搜尋特定字詞（⌘F (Windows, Linux Ctrl+F)）

  Git 輸出視窗會反白顯示搜尋字詞，並允許您在符合項目之間導航。搜尋框支援規則運算式，可用於進階搜尋。

  

啟用 Git 延伸模組的追蹤記錄

如需更詳細的診斷資訊，您可以為 Git 延伸模組啟用追蹤記錄。追蹤記錄會提供關於延伸模組運作的冗長資訊，包括內部狀態與詳細的指令執行過程。

若要啟用追蹤記錄：

1. 開啟 Git 輸出視窗

2. 選取輸出面板標題中的齒輪圖示，然後選擇一個記錄層級，例如 trace

   

   當您選擇一個記錄層級時，VS Code 會記錄該層級及以上層級的訊息。例如，選擇 trace 會記錄所有訊息，而選擇 error 則僅會記錄錯誤訊息。

後續步驟

• 原始碼控制常見問題 (FAQ) - 關於 Git 與原始碼控制的常見問題解答
• 原始碼控制概觀 - 了解 VS Code 的原始碼控制功能
• Git 文件 - 官方 Git 文件與資源