在 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。

此外,您可以在活动栏右下角的帐户菜单中登录 VS Code 的 GitHub 帐户,以启用其他功能,例如设置同步,以及从 GitHub 克隆和发布存储库。

Screenshot of the Accounts menu in VS Code

打开 Git 存储库

VS Code 提供了多种方式来在 Git 存储库中开始工作,从本地环境到GitHub Codespaces 等基于云的远程环境。

在本地克隆存储库

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

如果您从 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: 创建新 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: 在 VS Code 桌面版中打开命令,以便从您的本地 VS Code 桌面版连接到 codespace。

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

远程打开 GitHub 存储库

VS Code 的远程存储库支持允许您浏览和编辑 GitHub 存储库,而无需将其克隆到本地计算机。这对于快速对远程存储库进行更改而无需将整个代码库克隆到您的计算机非常有用。

  1. 首先安装 GitHub 存储库 扩展。

  2. 运行命令远程存储库: 打开远程存储库... 或使用资源管理器视图中的打开远程存储库按钮。

  3. 搜索并选择您要打开的 GitHub 存储库。

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

提示

如果您需要执行代码或运行终端命令,可以使用命令继续在此工作从远程存储库无缝切换到 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: 自动获取设置,以始终获取最新的远程提交指示器。

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

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 扩展。此扩展为 VS Code 添加了 PR 和问题跟踪功能,允许您在编辑器中创建、审查和合并 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 代码审查按钮。

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 打开。终端文档中提供了更高级的终端技巧。