🚀 在 VS Code 中免費取得

VS Code Git 簡介

想要輕鬆管理您的原始程式碼並與其他人協作嗎?Git 和 GitHub 是您需要的工具!透過 Visual Studio Code,您可以快速設定和使用它們。即使您是初學者,VS Code 的使用者友善介面也會引導您完成常見的 Git 動作,例如推送和提取程式碼、建立和合併分支,以及提交程式碼變更。如果您是專業人士,您會喜歡直接在編輯器中執行 Git 動作的功能,與使用 Git 命令列相比,可以節省您的時間和精力。此外,VS Code 和 Git 之間的無縫工作流程表示您可以留在編輯器中並完成更多工作。

透過 VS Code 中的 GitHub Copilot,您可以取得提交訊息、提取要求和在提交程式碼變更之前檢閱程式碼變更的建議。深入瞭解VS Code 中的 GitHub Copilot

提示

如果您還沒有 Copilot 訂閱,請註冊Copilot 免費方案,即可免費使用 Copilot。您將獲得每月完成和聊天互動的限制。

在 VS Code 中設定 Git

若要在 VS Code 中使用 Git 和 GitHub,請先確定您已在您的電腦上安裝 Git。如果 Git 遺失,原始檔控制檢視會顯示如何安裝 Git 的指示。之後請務必重新啟動 VS Code。

此外,您可以登入 VS Code,並在活動列右下角的 帳戶 功能表中登入您的 GitHub 帳戶,以啟用其他功能,例如設定同步,以及從 GitHub 複製和發佈存放庫。

Screenshot of the Accounts menu in VS Code

開啟 Git 存放庫

VS Code 提供幾種在 Git 存放庫中開始使用的方式,從本機到遠端雲端支援的環境,例如GitHub Codespaces

在本機複製存放庫

若要複製存放庫,請在命令面板中執行 Git:複製 命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P)),或在 原始檔控制 檢視中選取 複製存放庫 按鈕。

如果您從 GitHub 複製,VS Code 會提示您使用 GitHub 進行驗證。然後,從清單中選取要複製到您機器的存放庫。此清單包含公用和私人存放庫。

Screenshot of the Clone Repository quick prompt, searching for repositories with the name vscode

對於其他 Git 提供者,請輸入存放庫 URL,選取 複製,然後選取本機電腦上的資料夾以將檔案複製到其中。一旦存放庫在本機機器上複製完成,VS Code 就會開啟該資料夾。

Screenshot of the Clone Repository quick prompt, searching for a repository by providing the repository URL

在本機資料夾中初始化存放庫

若要初始化新的本機 Git 存放庫

  1. 選取電腦上現有的或新的資料夾,並在 VS Code 中開啟它。

  2. 原始檔控制 檢視中,選取 初始化存放庫 按鈕。

    這會在目前資料夾中建立新的 Git 存放庫,讓您可以開始追蹤程式碼變更。

    此動作相當於在命令列上執行 git init

    Source Control view for a workspace not under Git source control will offer to Initialize a Git repo or Publish to GitHub

將本機存放庫發佈到 GitHub

您也可以初始化本機存放庫並直接將其發佈到 GitHub。這會在您的 GitHub 帳戶上建立新的存放庫,並將您的本機程式碼變更推送至遠端存放庫。將您的原始程式碼放在遠端存放庫上是備份程式碼、與他人協作以及使用GitHub Actions自動化您的工作流程的絕佳方式。

使用 原始檔控制 檢視中的 發佈到 GitHub 命令按鈕。然後,您可以為存放庫選擇名稱和描述,以及是否設為公開或私人。

Screenshot of the Publish to GitHub quick prompt, showing private and public GitHub repository names

存放庫建立後,VS Code 會將您的本機程式碼推送至遠端存放庫。您的程式碼現在已備份在 GitHub 上,您可以開始與其他人透過提交和提取要求進行協作。

在程式碼空間中開啟 GitHub 存放庫

GitHub Codespaces 可讓您在完全設定的雲端式開發環境中開啟 GitHub 存放庫,讓您可以在瀏覽器中開發,而無需在本機電腦上安裝任何軟體。GitHub Codespaces 允許個人免費使用,這使得開始處理開放原始碼專案變得容易。

若要為您的 GitHub 存放庫建立程式碼空間

  1. 在 VS Code 中安裝GitHub Codespaces 擴充功能,並使用您的 GitHub 帳戶登入。

  2. 執行 Codespaces:建立新的程式碼空間 命令。

  3. 選取您要開啟的存放庫和分支。

    VS Code 會開啟一個新視窗,該視窗已連線到程式碼空間。原始程式碼、終端機以及執行和偵錯都託管在遠端雲端式開發環境中。

    請注意,檔案總管和狀態列會指出工作區是在程式碼空間中開啟。

    Screenshot of a workspace opened in a codespace, highlighting the codespace name in the File Explorer and Status Bar

或者,您也可以從GitHub Codespaces 網站上的程式碼空間範本開始。

如果您已經在瀏覽器中開啟程式碼空間,請在瀏覽器中執行 Codespaces:在 VS Code Desktop 中開啟 命令,以從您的本機 VS Code Desktop 連線到程式碼空間。

您可以在在程式碼空間中開發文件中瞭解更多關於 GitHub Codespaces 的資訊,包括轉送連接埠等自訂。

遠端開啟 GitHub 存放庫

VS Code 的遠端存放庫支援可讓您瀏覽和編輯 GitHub 存放庫,而無需將其複製到本機電腦。這對於快速變更遠端存放庫而無需將整個程式碼庫複製到您的機器非常有用。

  1. 首先安裝GitHub Repositories 擴充功能。

  2. 執行命令 遠端存放庫:開啟遠端存放庫... 或使用檔案總管檢視中的 開啟遠端存放庫 按鈕。

  3. 搜尋並選取您要開啟的 GitHub 存放庫。

    Remote Repositories opening a remote GitHub repo, pull request or Azure repo

提示

如果您需要執行程式碼或執行終端機命令,您可以使用命令 繼續在...上工作 從遠端存放庫無縫切換到程式碼空間。

暫存與提交程式碼變更

設定好 Git 存放庫後,您可以開始透過暫存和提交您新建立和編輯的程式碼來追蹤程式碼變更。

提示

儘早且經常提交您的變更。這讓您在需要時更容易還原到程式碼的先前版本。

您可以從活動列存取 原始檔控制 檢視,以列出工作區中所有已變更的檔案。您可以使用原始檔控制檢視標頭中的樹狀/清單圖示,在樹狀檢視或清單檢視之間切換。

Source Control view, highlighting the tree/list view control in the header

當您在原始檔控制檢視中選取檔案時,編輯器會顯示差異檢視,以醒目提示檔案變更,與先前提交的檔案進行比較。

Source Control view with one file staged and other changes, a diff showing in the editor that highlights the changes

若要暫存檔案,請選取 原始檔控制 檢視中檔案旁邊的 + (加號) 圖示。這會將檔案新增至 已暫存變更 區段,表示它將包含在下一次提交中。

Source Control view with four changed files, highlighting the '+' button to stage the changes of a file

您也可以一次暫存所有擱置中的變更,方法是選取原始檔控制檢視中 變更 旁邊的 + (加號) 圖示。

也可以透過選取檔案旁邊的 (減號) 圖示來捨棄已暫存的變更。同樣地,您可以透過選取原始檔控制檢視中 已暫存變更 旁邊的 (減號) 圖示來捨棄所有已暫存的變更。

Source Control view with four changed files, highlighting the '-' button to unstage the changes of a file

若要提交您已暫存的變更,請在上方的文字方塊中輸入提交訊息,然後選取 提交 按鈕。這會將您的變更儲存到本機 Git 存放庫,讓您可以在需要時還原到程式碼的先前版本。

提示

透過 VS Code 中的 GitHub Copilot,您可以根據您的程式碼變更產生提交訊息。深入瞭解使用 AI 產生提交訊息。在您提交變更之前,您也可以讓 Copilot 對未提交的程式碼變更進行程式碼檢閱

您可以在檔案總管檢視底部的 時間軸 檢視中導覽和檢閱所有本機檔案變更和提交。

Timeline view with one item selected and its change being shown in the editor

推送與提取遠端變更

一旦您對本機 Git 存放庫進行提交,您就可以將它們推送至遠端存放庫。同步變更 按鈕會指出將要推送和提取多少次提交。選取 同步變更 按鈕會下載 (提取) 任何新的遠端提交,並上傳 (推送) 新的本機提交到遠端存放庫。

Sync button with one change to push

提示

您可以啟用 Git:自動提取 設定,以始終取得最新的遠端提交指示器。

推送和提取也可以透過使用各自的命令個別執行。您可以從原始檔控制功能表存取這些命令。

Source Control menu that shows all source control commands

使用分支

在 Git 中,分支可讓您同時處理程式碼庫的多個版本。這對於試驗新功能或進行大型程式碼變更而不影響主要程式碼庫非常有用。

狀態列中的分支指示器會顯示目前的分支,並讓您切換到新的和現有的分支。

Branch indicator in the Status bar

若要建立新的分支,請選取分支指示器,然後選擇從目前分支或其他本機分支建立。輸入新分支的名稱,然後確認。VS Code 會建立新的分支並切換到該分支,讓您可以變更程式碼而不會影響主要分支。

Create branch quick prompt that shows when selecting the branch indicator

提示

如果您使用GitHub Pull Requests and Issues 擴充功能,您可以直接從 issue 建立分支,這可讓您開始在新的本機分支中工作,並自動預先填寫您的提取要求。

建立本機分支後,您可以透過在 原始檔控制 檢視中選取 發佈分支,將分支推送至遠端存放庫。這會在遠端存放庫上建立新的分支,讓您可以與該分支中的其他人協作。

建立和檢閱 GitHub 提取要求

在 Git 和 GitHub 中,提取要求 (PR) 是協作者檢閱和合併來自不同分支的程式碼變更到主要分支的方式。這使團隊能夠在將程式碼變更納入主要程式碼庫之前對其進行檢閱和核准,確保僅合併高品質的變更。

若要在 VS Code 中使用提取要求,您需要安裝GitHub Pull Requests and Issues 擴充功能。此擴充功能將 PR 和 issue 追蹤功能新增至 VS Code,讓您可以從編輯器內建立、檢閱和合併 PR。

若要建立 PR,請確定您位於與主要分支不同的分支上,並將您的程式碼變更推送至遠端存放庫。在 原始檔控制 檢視中,選取 建立提取要求 按鈕。這會開啟 PR 建立表單,您可以在其中輸入 PR 的標題和描述,並選擇要將變更合併到哪個分支。選取 建立 以建立 PR。

Source Control view, highlighting the 'Create pull request' button

提示

使用 GitHub Copilot 根據 PR 中包含的提交產生 PR 標題和描述。選取 PR 標題欄位旁邊的星光圖示以產生 PR 標題和描述。您也可以讓 Copilot 在您建立 PR 之前執行程式碼檢閱。選取 GitHub 提取要求檢視中的 Copilot 程式碼檢閱 按鈕。

VS Code 的 GitHub 文件中深入瞭解提取要求。

在內建終端機中使用 Git

由於所有 Git 狀態都保留在本機存放庫中,因此您可以輕鬆地在 VS Code 的 UI、內建終端機或外部工具 (例如GitHub Desktop) 之間切換。您也可以設定VS Code 作為您的預設 Git 編輯器,讓您可以使用 VS Code 來編輯提交訊息和其他 Git 相關檔案。

Windows 上的 Git Bash

Git Bash 是 Windows 的熱門 Shell 環境,它提供類似 Unix 的命令列介面,用於處理 Git 和其他命令列工具。Visual Studio Code 的整合式終端機支援 Git Bash 作為 Shell,讓您可以將 Git Bash 無縫整合到您的開發工作流程中。如果您在安裝步驟中沒有取消選取,則在 Windows 機器上安裝 Git 也會安裝 Git Bash。

Selecting Git Bash as shell in Visual Studio Code's built-in terminal

首先開啟 檢視 > 終端機 (⌃` (Windows、Linux Ctrl+`))。選取終端機面板中 + 圖示旁邊的下拉箭頭,以選取要開啟的新 Shell。如果已安裝 Git Bash,它會顯示在終端機和 Shell 清單中。您可以在終端機側邊欄中切換不同的終端機和 Shell。透過在 Visual Studio Code 中設定 Git Bash,您現在可以直接從程式碼編輯器中的終端機使用所有您喜愛的 Git 命令。

如果您想要將 Git Bash 設定為預設 Shell,請開啟終端機下拉式選單 (在 + 圖示旁邊),然後選取 選取預設設定檔。這會開啟可用 Shell 的清單,包括 Git Bash。選取Git Bash 會將其設定為您的預設 Shell,並且未來的所有終端機都將使用 Git Bash 開啟。更多進階終端機秘訣可在終端機文件中找到。