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"
  

開始使用儲存庫

當您開啟一個屬於 Git 儲存庫的資料夾時，VS Code 會自動偵測並啟用所有原始碼控制功能。若要開始使用新儲存庫或現有儲存庫，您有幾種選擇：

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

• 複製 (Clone) 儲存庫：從 GitHub 或其他 Git 主機複製現有的儲存庫。

• 開啟遠端儲存庫：使用 GitHub Repositories 擴充功能，無需將儲存庫複製到本機電腦即可進行作業。

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

原始碼控制介面

VS Code 透過幾個關鍵的介面元素提供 Git 功能。這種 UI 整合讓您無須了解終端機指令即可執行 Git 操作：

• 原始碼控制檢視：執行暫存、提交與管理變更等常見 Git 操作的中心樞紐。

  

• 原始碼控制圖表 (Source Control Graph)：提交歷程記錄與分支關係的圖形化呈現。

  

• 差異編輯器 (Diff editor)：並排顯示檔案比較，以便有效審閱變更。

  

• 其他 UI 元素：環境相關的 Git 資訊，例如編輯器裝訂槽指示器或 Git 註解 (blame annotations)。

  

常見工作流程

提交前審閱變更

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

暫存與提交變更

在「原始碼控制」檢視中審閱您的變更，然後選取每個檔案旁的 + 圖示來暫存檔案，或一次暫存所有變更。若需要更細緻的控制，可以在檔案的差異檢視中暫存特定的行或選取範圍。

在輸入方塊中輸入您的提交訊息，或選取提交訊息輸入方塊中的星號圖示 ()，讓 AI 根據您已暫存的變更來產生提交訊息。

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

與遠端同步

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

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

解決合併衝突

當您遇到合併衝突時，VS Code 會在「原始碼控制」檢視中標示出衝突的檔案。開啟含有衝突的檔案以查看內嵌的衝突標記。您有幾種解決衝突的方式：

• 使用內嵌編輯器動作，直接在編輯器中選擇如何解決衝突
• 使用三向合併編輯器 (3-way merge editor) 以並排檢視變更與合併結果
• 使用 AI 輔助功能來協助解決合併衝突

深入了解 解決合併衝突。

使用分支、工作樹與儲藏區 (Stashes)

VS Code 支援多種工作流程，以管理平行開發工作。

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

  

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

• 使用 Git 儲藏區 (stashes) 在需要快速切換內容時，暫時儲存未提交的變更。

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

檢視提交歷程記錄

檢視提交歷程記錄有助於了解程式碼隨時間的變更過程。

• 原始碼控制圖表提供了分支結構與提交歷程記錄的視覺呈現，並會標示傳入與傳出的提交。

  

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

  

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

使用 GitHub 合併請求 (Pull Requests) 與議題 (Issues)

VS Code 與 GitHub 整合，直接在您的編輯器中提供合併請求與議題管理。安裝 GitHub Pull Requests and Issues 擴充功能以：

• 建立、審閱與合併合併請求
• 檢視與管理議題
• 無需離開 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 工作樹以及儲藏 (stash) 操作

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

• 使用 GitHub - 了解如何在 VS Code 中處理合併請求與議題

• 疑難排解 - 使用輸出紀錄與追蹤紀錄來診斷並解決 Git 問題

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