JetBrains Rider 2026.1 Help

教程:在 JetBrains Rider 中开始使用 Git

本教程将向您展示如何在 JetBrains Rider 中执行最常用的 Git 操作。

您将学习如何为项目创建 Git 仓库、在 GitHub 上共享、提交并推送更改、创建和合并分支、解决合并冲突,以及查看文件历史。

第 1 步. 创建带有 Git 存储库的新解决方案

在本教程中,我们将创建一个简单的 解决方案,在 GitHub 上共享它,并执行一些 Git 任务。

  1. 启动 JetBrains Rider,然后在 欢迎 屏幕上点击 新建 解决方案

  2. 新建项目 向导中,从 新建项目 列表中选择 解决方案 类型(本教程我们将创建一个 空 解决方案 ),指定 解决方案 的名称(例如 gitdemo ),并提供路径。

    请选择 创建 Git 仓库 选项。

    新建解决方案对话框
  3. 单击 创建。 新的 解决方案 将在 JetBrains Rider 中打开。

您将收到通知,表示已为您的 解决方案 创建本地 Git 存储库。

现在您已创建包含 Git 仓库的新项目,用于 Git 操作的专用工具窗口变得可用。

Git 集成已启用
  1. VCS 微件: 管理 Git 分支并执行基本的 Git 操作。

  2. 提交 工具窗口(Ctrl+K视图 | 工具窗口 | 提交): 审查本地更改提交 到本地 Git 存储库。

  3. Git 工具窗口(Alt+9视图 | 工具窗口 | Git): 使用 Git 日志更多

第 2 步. 将文件添加到 Git

启用 Git 集成后,JetBrains Rider 会显示哪些文件已被修改、哪些新文件已添加到 Git,以及哪些文件未由 Git 跟踪。

要了解其工作方式,让我们创建一个简单的 README.md 文件,添加一段简短的说明,并将其添加到 Git。

  1. 资源管理器 工具窗口(Alt+1 )中,选择 解决方案 目录(gitdemo)。

  2. 点击 新建文件或目录 ,在工具窗口工具栏上(或按 Alt+Insert ),并从列表中选择 文件。 将文件命名为 README.md ,然后按 Enter

  3. 在打开的对话框中,单击 添加 ,以便 Git 开始跟踪该文件。

    将新文件添加到 Git

    现在,当您修改此文件时,JetBrains Rider 会自动为任何更改建立索引(换句话说,将其添加到 Git staging area ),因此您无需手动执行此操作。

  4. 将以下文本添加到新创建的文件:

    # Tutorial This is a tutorial where you will learn how to create Git repositories from your projects and share them on GitHub.

    Enter 以确保在此文本后,在文件中创建新的一行。 稍后我们将使用它来学习如何解决合并冲突。

    文本已添加到文件中。

现在,新文件已被 Git 跟踪,并添加到 提交 工具窗口中的 更改 更改列表。

包含新建文件的 Changes 更改列表

更改 更改列表可帮助您管理尚未提交到 Git 存储库的本地更改。 详细了解请参阅 将更改分组到changelist中

第 3 步. 将您的解决方案提交到本地 Git 存储库

现在,让我们将要共享的所有文件添加到存储库,并提交它们以保存其当前状态。

  1. 提交 工具窗口中,通过点击文件旁的复选框选择要提交的文件。

  2. 为您的第一次提交输入消息(例如, Add a new project to Git):

    提交工具窗口中的提交消息
  3. 单击 提交

    如果您此前未在计算机上使用 Git,在提交更改之前,JetBrains Rider 将要求您输入您的用户名和电子邮件地址。 Git 会将此信息存储在 .git/config 中,以便将您标识为提交的作者。

    JetBrains Rider 会在提交成功后通知您:

    文件已提交通知

步骤 4。 在 GitHub 上共享您的解决方案

要使您的 解决方案 可供其他贡献者使用,您需要将其发布到远程存储库,例如在 GitHubGitLab 上。 JetBrains Rider 提供与这两个平台的集成。 详细信息请参阅 管理托管在 GitHub 上的项目管理托管在 GitLab 上的项目

在本教程中,我们将在 GitHub 上发布我们的 解决方案。

  1. 在主菜单中,进入 Git | GitHub | 在 GitHub 上共享项目.

  2. 在打开的对话框中,您可以更改仓库名称(默认与 解决方案 名称相同)、远程名称(默认是 origin )、选择仓库类型(公开或私有),并在需要时添加说明。

    保留 代码库名称远程 字段中的默认值。 选择 private 选项。

    如果您尚未在 GitHub 上注册,请单击 添加帐户 ,然后单击 通过 GitHub 登录

    在 GitHub 上共享项目对话框

    在打开的浏览器窗口中输入您的 GitHub 凭据,或在其中创建一个新帐户。 返回 JetBrains Rider 后, 通过以下方式共享 字段将显示您的帐户名称。

  3. 单击 共享。 项目成功发布到 GitHub 后,将出现以下通知:

    仓库已共享到 GitHub

    点击通知中的链接以在 GitHub 上打开仓库。

步骤 5。 创建一个新分支

您可能需要创建一个独立的分支,例如,当您在开发新功能且不希望在测试之前让更改进入主分支时。

  1. Ctrl+T 或转到 Git | 更新项目},{。 在打开的 更新项目 对话框中,保留默认合并选项。 点击 确定 拉取当前分支的最新版本。

    更新项目对话框已打开。
  2. VCS 微件显示您当前分支的名称 — main。 点击它,在 本地 节点中选择 main 分支,然后点击 从 'main' 新建分支

    Git 分支菜单
  3. 在打开的对话框中,指定分支名称(例如 new_feature ),并选择 签出分支 选项以立即切换到新分支。

    新建 Git 分支

    现在,您已切换到新创建的分支:

    已切换到新分支

步骤 6。 进行并查看更改

  1. 向 解决方案 添加一个新文件(例如, git-features.md ),当 JetBrains Rider 建议将其添加到 Git 版本控制时,点击 添加

    之后,打开 README.md 文件,并将现有文本替换为新的描述:

    # Demo This is a demo project where you will learn how to commit and push changes, create and merge branches. Refer to `git-features.md` to check the list of Git operations.

    资源管理器 工具窗口(Alt+1 )以及编辑器标签页中,JetBrains Rider 会对不同的文件使用不同的颜色:蓝色代表已修改,绿色代表新添加。 此外,在已修改文件的边距区域,彩色更改标记会出现在修改的行旁边。

    编辑器和 Explorer 工具窗口中的更改
  2. 要查看具体更改内容,请点击边距标记:

    彩色更改标记

    若要在单独的编辑器标签页中查看差异,请点击 显示差异图标显示行差异

    作用域差异
  3. 转到 提交 工具窗口,可一次性预览所有更改。 双击文件以在编辑器中打开差异视图:

    本地更改

    了解更多信息请参见 调查 Git 仓库中的更改

步骤 7。 提交并推送更改

在我们的 new_feature 分支中,我们创建了一个新的 git-features.md 文件,并修改了 README.md 文件。 让我们提交更改并将其推送到远程存储库。

  1. 提交 工具窗口中,勾选我们两个文件旁的复选框,并输入提交消息(例如 Update README.md)。

    在输入提交消息时,您可以对 解决方案 文件名使用 自动补全Ctrl+Space):

    提交消息中的自动完成

    单击 提交

  2. Ctrl+Shift+K 或从主菜单中选择 Git | 推送 将更改推送到远程仓库。 推送提交 对话框已打开。 在此,您可以查看所有将要推送的提交以及所有受影响的文件。

    在推送更改之前,您可以查看每个文件的差异。 为此,右键点击一个文件并选择 显示差异图标显示差异 或按 Ctrl+D

    推送提交
  3. 单击 推送

    之后,JetBrains Rider 会将所有更改推送到 GitHub 上的远程仓库。

步骤 8。 合并分支并解决冲突

您可以通过多种方式将更改从一个分支应用到另一个分支,例如合并和变基分支、挑拣提交、应用单独的更改或文件。 所有这些方法都在 合并、变基或挑拣以应用更改 中有详细说明。

在本教程中,您将学习如何合并两个分支。 我们还将有意制造一次合并冲突,以学习如何使用 JetBrains Rider 的合并工具轻松解决合并冲突。

合并分支

  1. Git 分支 微件中选择 main 分支,然后点击 签出

  2. 第 6 步 中,我们在 new_feature 分支修改了 README.md 文件。 现在,让我们在 main 分支中再次更新文本,以模拟合并冲突:

    # Tutorial This is a test project where you will learn how to work with the most popular Git operations.

    Enter 以确保在此文本后于文件中新建一行,就像在 步骤2中做的那样。 这将在后续解决冲突时帮助我们。

  3. 按照 第 7 步 中的说明提交并推送更改。 输入提交消息(例如, Add information about Git tutorial)。

  4. 在 VCS 微件的 本地 节点中,选择 new_feature 并点击 将 'new_feature' 合并到 'main'

    VCS 微件菜单中的合并选项

由于我们在不同分支中对同一文件进行了更改, 冲突 对话框出现。

冲突对话框

解决冲突

  1. 冲突 对话框中,您有几种选项来解决冲突:

    • 接受您的更改 :保留当前分支中的更改。

    • 接受他们的更改 :应用您要合并到当前分支的分支中的更改。

    • 合并 :在专用对话框中手动解决冲突。

    单击 合并合并修订 对话框打开:

    解决冲突
    • 左侧窗格称为 来自 main 的更改 ,显示来自本地副本的只读更改。

    • 右侧窗格称为 来自 new_feature 的更改 ,显示来自我们要合并到 mainnew_feature 分支的只读传入更改。

    • 中间窗格称为 结果 ,是一个功能齐全的编辑器,显示冲突解决的结果。

  2. 在该对话框中,您可以通过点击 从左侧应用更改/从右侧应用更改 来接受更改,或点击 拒绝更改,也可以在中间的 结果 窗格中编写代码。 详细了解请参阅 解决 Git 冲突

    让我们从左侧窗格中的 main 接受一处更改,方法是点击 从左侧应用更改。 由于我们不需要来自 new_feature 的同一行更改,请在右侧窗格中冲突行的红色区域中点击 移除 以丢弃这些更改。

    在右侧窗格中,点击 从右侧应用更改 以应用来自 new_feature 的其余非冲突更改。

    在中间窗格中审查合并结果。 合并后的文本应如下所示:

    # Demo This is a test project where you will learn how to work with the most popular Git operations. Refer to `git-features.md` to check the list of Git operations.
    冲突已解决
  3. 单击 Apply

    JetBrains Rider 会将 new_feature 分支合并到 main 分支。

  4. 通过按 Ctrl+Shift+K 或从主菜单中选择 Git | 推送 将更改推送到远程仓库。

您可以在 Git 工具窗口(Alt+9 )的 日志 标签页中查看所有分支的提交:

Git 日志选项卡

在此,您还可以还原提交、将一个分支的更改拣选到另一个分支,等等。 有关详细信息,请参阅 仓库选项卡

步骤 9。 查看历史记录

当您与他人共同处理 解决方案 时,您可能会想知道该文件为何、何时以及如何被更改。

main 分支中,打开 README.md 文件。 要找出这些更改来自哪个提交,请执行以下操作之一:

  • 在编辑器或者 资源管理器 工具窗口(Alt+1 )中右键点击文件并选择 Git | 显示历史Git 工具窗口的 历史记录 选项卡将打开:

    Git 文件历史记录

    在此选项卡上,您可以查看影响该文件的所有提交,并找出您感兴趣的更改是在哪个提交中添加的。

  • 在编辑器中,选择您要查看历史记录的代码片段,右键单击所选内容,然后选择 Git | 显示所选内容的历史。 将打开 选定内容的历史记录 对话框:

    选定内容的 Git 历史记录

    在这里,您可以审查影响您所选代码的所有提交。

调查 Git 仓库中的更改 中了解更多探索 Git 历史记录的方法。

汇总

在本教程中,您学习了如何:

后续步骤

如果您在本教程中没有找到如何执行某些特定的 Git 任务,请参阅 Git 指南——其中介绍了 IDE 中提供的所有 Git 操作。

如果您的 解决方案 未受 Git 管理,您仍可使用 本地历史记录 功能跟踪并管理本地更改、回滚到特定文件状态、恢复已删除文件等。

2026年 3月 25日