尝试在 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,源代码管理视图会显示如何安装它的说明。之后请务必重新启动 VS Code。

此外,你可以在活动栏右下角的帐户菜单中使用 GitHub 帐户登录 VS Code,以启用诸如设置同步等附加功能,还可以从 GitHub 克隆和发布仓库。

Screenshot of the Accounts menu in VS Code

打开 Git 仓库

VS Code 提供了多种在 Git 仓库中入门的方式,从本地环境到像GitHub Codespaces 这样的远程云端环境。

在本地克隆仓库

要克隆仓库,请在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中运行Git: Clone 命令,或在源代码管理视图中选择克隆仓库按钮。

如果你从 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,你可以开始使用提交和拉取请求与他人协作。

在 codespace 中打开 GitHub 仓库

GitHub Codespaces 允许你在完全配置的云端开发环境中打开 GitHub 仓库,使你无需在本地计算机上安装任何软件即可在浏览器中进行开发。GitHub Codespaces 为个人提供免费使用,这使得轻松开始参与开源项目成为可能。

为你的 GitHub 仓库创建 codespace

  1. 在 VS Code 中安装GitHub Codespaces 扩展并使用你的 GitHub 帐户登录。

  2. 运行 Codespaces: Create New Codespace 命令。

  3. 选择要打开的仓库和分支。

    VS Code 会打开一个新窗口,该窗口连接到 codespace。源代码、终端以及运行和调试都在远程云端开发环境中进行。

    注意文件资源管理器和状态栏会指示工作区是在 codespace 中打开的。

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

另外,你也可以从GitHub Codespaces 网站上的 codespace 模板开始。

如果你的浏览器中已经打开了 codespace,请在浏览器中运行 Codespaces: Open in VS Code Desktop 命令,以便从本地 VS Code 桌面连接到 codespace。

你可以在在 codespace 中开发文档中了解有关 GitHub Codespaces 的更多信息,包括端口转发等自定义设置。

远程打开 GitHub 仓库

VS Code 的远程仓库支持允许你在不将其克隆到本地计算机的情况下浏览和编辑 GitHub 仓库。这对于快速更改远程仓库而无需将整个代码库克隆到你的计算机上非常有用。

  1. 首先安装GitHub Repositories 扩展。

  2. 运行命令 Remote Repositories: Open Remote Repository... 或使用资源管理器视图中的打开远程仓库按钮。

  3. 搜索并选择要打开的 GitHub 仓库。

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

提示

如果你需要执行代码或运行终端命令,可以使用命令 Continue Working on 从远程仓库无缝切换到 codespace。

暂存并提交代码更改

设置好 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: Autofetch 设置,以始终获取最新的远程提交指示。

推送和拉取也可以通过使用各自的命令单独执行。你可以从源代码管理菜单访问这些命令。

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 扩展,你可以直接从问题创建分支,这会让你在新本地分支中开始工作并自动为你预填充拉取请求。

创建本地分支后,你可以通过在源代码管理视图中选择发布分支将分支推送到远程仓库。这会在远程仓库上创建新分支,允许你在此分支中与他人协作。

创建和评审 GitHub 拉取请求

在 Git 和 GitHub 中,拉取请求(PR)是协作人员评审和合并来自不同分支的代码更改到主分支的一种方式。这使得团队可以在代码更改合并到主代码库之前进行评审和批准,确保只合并高质量的更改。

若要在 VS Code 中使用拉取请求,你需要安装GitHub Pull Requests and Issues 扩展。此扩展将 PR 和问题跟踪功能添加到 VS Code 中,允许你在编辑器内创建、评审和合并 PR。

要创建 PR,确保你处于主分支之外的单独分支上,并将代码更改推送到远程仓库。在源代码管理视图中,选择创建拉取请求按钮。这会打开 PR 创建表单,你可以在其中输入 PR 的标题和说明,并选择将更改合并到哪个分支。选择创建以创建 PR。

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

提示

使用 GitHub Copilot 根据 PR 中包含的提交生成 PR 标题和说明。选择 PR 标题字段旁边的闪光图标以生成 PR 标题和说明。你也可以在创建 PR 之前让 Copilot 对 PR 进行代码评审。在 GitHub 拉取请求视图中选择Copilot Code Review 按钮。

VS Code 的 GitHub 文档中了解有关拉取请求的更多信息。

在内置终端中使用 Git

由于所有 Git 状态都保存在本地仓库中,因此你可以轻松在 VS Code 的 UI、内置终端GitHub Desktop 等外部工具之间切换。你还可以将VS Code 设置为你的默认 Git 编辑器,允许你使用 VS Code 编辑提交消息和其他与 Git 相关的文件。

Windows 上的 Git Bash

Git Bash 是 Windows 上一种流行的 shell 环境,它为使用 Git 和其他命令行工具提供了一个类似 Unix 的命令行界面。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 打开。更多高级终端技巧可在终端文档中获取。