原始碼控制疑難排解

本文將協助您使用輸出記錄和追蹤記錄，來診斷並解決 Visual Studio Code 中的 Git 問題。當 Git 操作失敗或發生預期外的行為時，請使用這些診斷工具。

Git 輸出視窗

VS Code 會使用您電腦上安裝的 Git 來執行原始碼控制操作。「Git 輸出視窗」提供由 VS Code 執行的 Git 命令的詳細記錄。這些資訊有助於了解正在執行哪些 Git 操作以及診斷問題。

若要開啟 Git 輸出視窗

• 在「原始碼控制」檢視中，選取 ... 功能表並選取顯示 Git 輸出

• 從命令選擇區執行 Git: Show Git Output 命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))

• 開啟輸出面板 (⇧⌘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 則只會記錄錯誤訊息。

後續步驟

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