快速入門：在 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 問題。
• 原始檔控制概觀 - 原始檔控制功能的完整參考。