快速入門：在 VS Code 中使用原始檔控制

在幾分鐘內開始在 Visual Studio Code 中使用 Git。本指南涵蓋了設定儲存庫、儲存變更和同步程式碼的基本知識。

先決條件

1. 安裝 Git：請確認您的電腦上已安裝 Git。下載 Git

2. 開啟 VS Code：請確認您已安裝最新版本的 Visual Studio Code。

步驟 1：開啟專案

您可以從現有的 Git 儲存庫或本機專案資料夾開始。

選項 A：在本機複製儲存庫

如果您想在 GitHub、Azure DevOps 或其他 Git 提供者上託管的程式碼上工作，請複製儲存庫。如果您之前已複製儲存庫，您可以直接在 VS Code 中開啟該資料夾，VS Code 將自動偵測 Git 儲存庫。

在 VS Code 中複製儲存庫

1. 開啟原始檔控制檢視 (⌃⇧G (Windows、Linux Ctrl+Shift+G)) 並選取**複製儲存庫**

   

   另外，開啟命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 並輸入 Git: Clone。

2. 輸入儲存庫 URL (例如，https://github.com/microsoft/PowerToys)

   如果您是從 GitHub 複製，您也可以選取**從 GitHub 複製**並登入您的 GitHub 帳戶以查看您的儲存庫清單。

3. 選取您電腦上的父資料夾以儲存專案

4. 當提示您在 VS Code 中開啟複製的儲存庫時，請選取**開啟**

5. 在工作區信任對話方塊中確認您是否信任此儲存庫

   注意

   僅信任您已知來源的儲存庫。不受信任的程式碼可能會損害您的電腦。

選項 B：在本機資料夾中初始化儲存庫

若要使用 Git 啟動新專案，您可以在現有的本機資料夾中初始化儲存庫。此選項會在您的資料夾中建立一個新的 Git 儲存庫來追蹤變更。

1. 在 VS Code 中開啟您的專案資料夾 (**檔案** > **開啟資料夾...**)。

2. 開啟原始檔控制檢視 (⌃⇧G (Windows、Linux Ctrl+Shift+G)) 並選取**初始化儲存庫**

   

   另外，開啟命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 並輸入 Git: Initialize Repository。

步驟 2：進行變更並檢閱

Git 會追蹤專案中檔案的變更。VS Code 中的原始檔控制檢視是您管理這些變更的中心，而無需使用命令列。

讓我們進行一個簡單的程式碼變更，並使用原始檔控制檢視和差異編輯器來檢閱它。

1. 編輯專案中的現有檔案，然後儲存。

   如果您剛剛初始化了新的儲存庫，您可以繼續下一步。

2. 開啟原始檔控制檢視 (⌃⇧G (Windows、Linux Ctrl+Shift+G))。

   請注意，變更的檔案會列在**變更**下方，旁邊有 "U" (未追蹤) 或 "M" (已修改) 圖示。活動列中的原始檔控制圖示也會顯示一個徽章，其中包含受影響檔案的數量。

   

3. 若要檢閱檔案的變更，請在原始檔控制檢視中選取該檔案以開啟差異編輯器。

   差異編輯器會顯示檔案目前版本與上次提交版本之間的差異。如果視窗夠寬，差異編輯器會並排顯示比較，否則會以行內方式顯示變更。

   

   提示

   如果您有 Copilot 訂閱，請在原始檔控制檢視中選取「程式碼檢閱」按鈕，以便在提交變更之前執行 AI 驅動的程式碼檢閱。

   

步驟 3：暫存並提交

Git 使用兩步驟程序來儲存變更：暫存 (準備) 和提交 (儲存)。在原始檔控制檢視中，變更會先列在**變更**下方，暫存後會移至**已暫存的變更**，準備好進行提交。

1. 若要暫存您的變更，請執行以下其中一項

   • 將滑鼠游標停留在**變更**清單中的檔案上方，然後選取 **+** (加號) 以暫存它

     

   • 在**變更**清單中以滑鼠右鍵按一下檔案，然後選取**暫存變更**

   • 將滑鼠游標停留在**變更**標頭上方，然後選取 **+** (加號) 按鈕以一次暫存所有變更

2. (選用) 如有需要，您可以取消暫存變更或捨棄變更

   • 若要取消暫存檔案，請將滑鼠游標停留在**已暫存的變更**清單中的檔案上方，然後選取 **-** (減號) 按鈕

   • 若要捨棄檔案的變更，請在**變更**清單中以滑鼠右鍵按一下它，然後選取**捨棄變更**

3. 若要提交已暫存的變更，您可以提供提交訊息。

   1. 在原始檔控制檢視頂部的文字方塊中輸入提交訊息。

      您也可以選取提交訊息輸入方塊中的閃爍圖示 ，使用 AI 根據您已暫存的變更產生提交訊息。

   2. 選取**提交**以將您的變更提交到 Git 歷史記錄

      

      提交後，已暫存的變更會從原始檔控制檢視中清除，並儲存到您的本機 Git 歷史記錄中。

      注意

      只有已暫存的變更才會包含在提交中。如果您有未暫存的變更，它們會保留在**變更**下方以供將來提交。

4. 若要查看您的提交歷史記錄，請在原始檔控制檢視中選取**原始檔控制圖表**。

   

步驟 4：與伺服器同步

如果您的儲存庫已連接到遠端伺服器 (例如 GitHub 或 Azure DevOps)，您可以將您的本機提交與遠端儲存庫同步。

1. 開啟原始檔控制檢視 (⌃⇧G (Windows、Linux Ctrl+Shift+G))

2. 選取**同步變更**以從遠端提取最新變更並推送您的本機提交

   

   另外，狀態列會顯示同步狀態，並讓您透過選取同步圖示 (旋轉箭頭) 來同步變更。

3. 選取它以從伺服器提取新變更並推送您的提交。

4. 若要單獨提取或推送，請在原始檔控制檢視中選取省略符號選單 (...)，然後選擇**提取**或**推送**。

   

後續步驟

既然您已了解基礎知識，請探索更多功能

• 分支和工作樹 - 了解分支管理和平行開發。
• 儲存庫和遠端 - 了解如何複製、發佈以及與遠端儲存庫同步。
• 解決合併衝突 - 了解如何在合併分支時處理衝突。
• 使用 GitHub - 了解提取要求和問題。
• 疑難排解 - 診斷並解決 Git 問題。
• 原始檔控制概觀 - 原始檔控制功能的完整參考。