VS Code 中的版本控制

Visual Studio Code 內建版本控制管理 (SCM)，讓您能直接在編輯器中使用 Git 及其他版本控制系統。Git 支援已內建，您也可以從 Visual Studio Marketplace 安裝其他 SCM 提供者的延伸模組。

整合式版本控制介面透過圖形化介面提供 Git 功能，而非使用終端機指令。您可以執行 Git 操作，例如暫存變更、提交檔案、建立分支及解決合併衝突，而無需切換到命令列。

您在 VS Code 介面中所做的變更會與命令列 Git 操作同步，因此您可以根據需要同時使用 UI 和終端機。版本控制介面是與命令列並行運作，而非取代它。

先決條件

若要在 VS Code 中使用 Git 功能，您需要

• VS Code 使用您電腦上安裝的 Git。請在您的機器上 安裝 Git 2.0.0 或更新版本。

• 當您提交變更時，Git 會使用您設定的使用者名稱和電子郵件。您可以使用以下方式設定這些值

  git config --global user.name "Your Name"
  git config --global user.email "your.email@example.com"
  

開始使用存放庫

VS Code 會在您開啟 Git 存放庫資料夾時自動偵測，並啟用所有版本控制功能。若要開始使用新存放庫或現有存放庫，您有幾種選擇

• 將存放庫初始化：為您目前的資料夾建立一個新的 Git 存放庫。

• 複製存放庫：從 GitHub 或其他 Git 主機複製現有的存放庫。

• 開啟遠端存放庫：使用 GitHub Repositories 延伸模組，無需將存放庫複製到本機即可進行操作。

深入了解 複製與發佈存放庫。

版本控制介面

VS Code 透過幾個關鍵介面元素提供 Git 功能。此 UI 整合讓您無需知曉終端機指令即可執行 Git 操作

• 版本控制檢視：執行暫存、提交及管理變更等常見 Git 操作的中心樞紐

  

• 版本控制圖表：提交歷程記錄與分支關係的圖形化表示

  

• 差異 (Diff) 編輯器：並排檔案比較，用於有效的變更檢閱

  

• 其他 UI 元素：內容相關的 Git 資訊，例如編輯器邊欄指標或 Git blame 標註

  

常見工作流程

在提交前檢閱變更

在提交變更之前，檢閱變更以確保準確性與品質非常重要。使用 VS Code 的 AI 功能對您的變更進行程式碼檢閱，並在編輯器中取得檢閱評論與建議。

暫存並提交變更

在版本控制檢視中檢閱您的變更，然後選取每個檔案旁邊的 + 圖示來暫存檔案，或是全選所有變更進行暫存。如需更精細的控制，可以從檔案的差異檢視中暫存特定的行或選取項目。

在輸入框中輸入您的提交訊息，或選取提交訊息輸入框中的閃爍圖示 ()，使用 AI 根據您的暫存變更產生提交訊息。

深入了解 暫存變更與撰寫提交。

與遠端同步

當您的分支連接到遠端分支時，VS Code 會在狀態列顯示同步狀態，並在版本控制檢視中顯示傳入與傳出的提交。您可以快速同步或執行個別的擷取 (fetch)、拉取 (pull) 及推送 (push) 操作。

深入了解 使用存放庫與遠端。

解決合併衝突

當您遇到合併衝突時，VS Code 會在版本控制檢視中標示發生衝突的檔案。開啟有衝突的檔案以查看行內衝突標記。您有幾種解決衝突的選擇

• 使用行內編輯器動作，直接在編輯器中選擇如何解決衝突
• 使用三向合併編輯器並排查看變更與合併結果
• 使用 AI 協助解決合併衝突

深入了解 解決合併衝突。

使用分支、工作樹與儲藏

VS Code 支援多種用於管理平行開發工作的工作流程。

• 在單一工作區內快速切換分支，以處理不同的功能或修復。

  

• 使用 Git 工作樹 (Worktrees) 為不同分支建立獨立的工作目錄，以便同時處理多個分支。

• 當您需要快速切換上下文時，使用 Git 儲藏 (Stashes) 來暫時儲存未提交的變更。

深入了解 使用分支與工作樹。

檢視提交歷程記錄

檢閱提交歷程記錄有助於了解您的程式碼隨時間變化的情形。

• 版本控制圖表提供您的分支結構與提交歷程記錄的視覺化表示，並醒目提示傳入與傳出的提交。

  

• 檔案總管檢視中的時間軸檢視會顯示特定檔案的提交歷程記錄，讓您查看其演變過程。您可以篩選時間軸，使其僅顯示 Git 提交，或同時包含本機檔案變更。

  

深入了解 使用圖表與時間軸檢視以及檢閱變更。

使用 GitHub 提取要求 (Pull Request) 與議題 (Issue)

VS Code 與 GitHub 整合，可直接在編輯器中提供提取要求與議題管理。安裝 GitHub Pull Requests and Issues 延伸模組以

• 建立、檢閱及合併提取要求 (Pull Request)
• 檢視與管理議題 (Issue)
• 無需離開 VS Code 即可對 PR 進行評論與核准
• 簽出 PR 分支並在本機檢閱變更

深入了解 在 VS Code 中使用 GitHub。

其他版本控制提供者

VS Code 支援多種版本控制提供者。雖然內建了 Git 支援，但您可以為 Azure DevOps、Subversion 或 Mercurial 等其他版本控制系統 安裝延伸模組。

在延伸模組檢視 (⇧⌘X (Windows, Linux Ctrl+Shift+X)) 中搜尋 @category:"scm providers" 以瀏覽可用的 SCM 提供者延伸模組。

後續步驟

• 版本控制快速入門 - 在 VS Code 中快速開始使用 Git 版本控制

• 入門影片 - Git 版本控制 - 提供 VS Code Git 支援概覽的入門影片

• 分支與工作樹 - 了解分支管理、Git 工作樹及儲藏操作

• 存放庫與遠端 - 了解複製、發佈及與遠端存放庫同步

• 使用 GitHub - 了解如何在 VS Code 中處理提取要求與議題

• 疑難排解 - 透過輸出記錄與追蹤記錄診斷並解決 Git 問題

• VS Code 中的 Copilot - 探索 Git 工作流程之外更多由 AI 驅動的功能