# 教程：在 CLion 中入门使用 Git

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> 必需插件：   Git   和   GitHub  （默认情况下捆绑并启用）

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

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

## 步骤 1。 创建包含 Git 仓库的新项目

在本教程中，我们将创建一个简单的 项目，在 GitHub 上共享它，并执行一些 Git 任务。

Procedure:

1. 启动 CLion。

在 CLion 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 在   新项目   向导中，从   新项目   列表选择 项目 类型（本教程将创建一个   空 项目  ），指定 项目 的名称（例如  `gitdemo` ），并提供位置路径。

请选择   创建 Git 仓库  选项。

![新建项目](https://resources.jetbrains.com/help/img/idea/2026.3/gitdemo_empty_project.png)

3. 点击   创建  。 新的 项目 将在 CLion 中打开。

> **Note:**
> CLion 会自动检测您的计算机上是否安装了 Git。 如果 IDE 无法找到 Git 可执行文件，会建议您下载。

您将收到通知，表示已为您的 项目 创建本地 Git 存储库。

现在您已创建带有 Git 仓库的新项目，用于 Git 操作的专用工具窗口已可用。

![Git 集成已启用](https://resources.jetbrains.com/help/img/idea/2026.3/git_integration_enabled.png)

1.  VCS 微件： [管理 Git 分支](manage-branches.html) 并执行基本的 Git 操作。

2.    提交   工具窗口（ `Ctrl+K` (Windows), `⌘ K` (macOS), `⌘ K` (IntelliJ IDEA Classic (macOS)), `⌘ K` (macOS System Shortcuts), `Ctrl+K` (XWin), `Ctrl+K` (GNOME), `Ctrl+K` (KDE), `Ctrl+K` (Emacs), `Ctrl+K` (Sublime Text), `Ctrl+K` (Sublime Text (macOS)), `⌘ ⌥ C` (Xcode), `Ctrl+Alt+K` (Visual Studio), `⌘ ⌥ ⇧ K` (Visual Studio (macOS)), `Ctrl+K` (ReSharper), `⌘ K` (ReSharper (macOS)), `Alt+G, Alt+C` (QtCreator), `⌃ G, ⌃ C` (QtCreator (macOS)), `Ctrl+K` (NetBeans), `Ctrl+K` (Eclipse), `Ctrl+K` (Eclipse (macOS)) 或  `视图 | 工具窗口 | 提交` ）： [查看本地更改](adding-files-to-version-control.html)并 [提交](#commit_and_push)到本地 Git 仓库。

3.    Git   工具窗口（ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 或  `视图 | 工具窗口 | Git` ）： [使用 Git 日志](investigate-changes.html)和 [更多](version-control-tool-window.html)。

> **Tip:**
> 在   提交   工具窗口中，有一个新建的 IDE 配置文件列表（如  `.xml`  和  `.iml` ）以及一个  `.gitignore`  文件。 我们将直接提交它们，而无需直接操作这些文件。 对于个人项目这是常规做法，但要注意大型团队通常更谨慎地共享这些文件，以避免开发者之间配置冲突。 有关详细信息，请参阅 [官方 Git 文档](https://git-scm.com/docs/gitignore) 和 [将文件排除在版本控制之外（忽略）](set-up-a-git-repository.html#ignore-files)。

## 步骤 2。 将文件添加到 Git

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

为了解其工作方式，咱们可以创建一个简单的  `README.md`  文件并写入简要说明，然后将其添加到 Git。

Procedure:

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，选择 项目 目录（  `gitdemo` ）。

2. 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)   新建文件或目录   于工具窗口工具栏（或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))），并从列表中选择   文件  。 将文件命名为  `README.md` ，然后按下   `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))  。

3. 在打开的对话框中点击   Add  ，以便让 Git 开始跟踪该文件。

![将新文件添加到 Git](https://resources.jetbrains.com/help/img/idea/2026.3/add_file_to_git.png)

现在每当您修改该文件时，CLion 会自动为所有更改建立索引（即将其添加至 [Git 暂存区](https://git-scm.com/docs/git-add)），无需手动操作。

> **Tip:**
> 如果您不小心关闭了此对话框，您可以在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中将该文件添加到 Git：右键点击该文件并选择  `Git | 添加` 。

4. 将以下文本添加至新创建的文件：

```MARKDOWN
# Tutorial

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


```

按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 以确保在此文本后于文件中创建一个新行。 稍后我们将用它来学习如何解决合并冲突。

![文本已添加到文件中。](https://resources.jetbrains.com/help/img/idea/2026.3/git_readme_md_added.png)

现在，新文件已由 Git 跟踪，并已添加到   提交   工具窗口 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) 中的   更改   更改列表。

![更改清单包含新创建的文件](https://resources.jetbrains.com/help/img/idea/2026.3/file_added_to_git.png)

更改   更改清单可帮助您管理尚未提交至 Git 仓库的本地更改。 了解更多信息请参见 [将更改分组到changelist中](managing-changelists.html)。

## 步骤 3。 将您的项目提交到本地 Git 仓库

现在，让我们将所有希望共享的文件添加到仓库中并提交，以保存其当前状态。

Procedure:

1. 在   提交   工具窗口 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) 中，通过点击文件旁边的复选框选择要提交的文件。

> **Tip:**
> 在   提交   工具窗口 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) 中，您还可以预览新增和修改的文件，使用高级提交选项，在提交中添加或排除文件，以及 [更多](commit-and-push-changes.html)。

> **Tip:**
> 在   提交   工具窗口中，有一个新建的 IDE 配置文件列表（如  `.xml`  和  `.iml` ）以及一个  `.gitignore`  文件。 我们将直接提交它们，而无需直接操作这些文件。 对于个人项目这是常规做法，但要注意大型团队通常更谨慎地共享这些文件，以避免开发者之间配置冲突。 有关详细信息，请参阅 [官方 Git 文档](https://git-scm.com/docs/gitignore) 和 [将文件排除在版本控制之外（忽略）](set-up-a-git-repository.html#ignore-files)。

2. 为您的首次提交输入消息（例如，  `Add a new project to Git` ）：

![提交工具窗口中的提交信息](https://resources.jetbrains.com/help/img/idea/2026.3/commit_message.png)

3. 点击   提交  。

如果您的计算机上未使用过 Git，则在提交更改前，CLion 会要求您输入用户名和电子邮件。 Git 会将该信息存储在  `.git/config`  中，用于识别提交作者身份。

成功提交后，CLion 会通知您：

![文件已提交通知](https://resources.jetbrains.com/help/img/idea/2026.3/committed_file.png)

> **Tip:**
> 您可以通过点击通知弹窗中的   编辑提交消息   来编辑提交信息。 您还可以通过   Git   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 对任何提交进行同样的操作。 在   日志   标签页，选择分支后，右键点击所需提交并选择   编辑提交消息  。

## 步骤 4。 在 GitHub 上共享您的项目

要使您的 项目 可供其他贡献者使用，您需要将其发布到远程存储库，例如在 [GitHub](https://github.com) 或 [GitLab](https://about.gitlab.com/) 上。 CLion 提供对这两个平台的集成。 详细信息可参见 [管理托管在 GitHub 上的项目](manage-projects-hosted-on-github.html) 和 [管理托管在 GitLab 上的项目](clone-gitlab-project.html)。

在本教程中，我们将在 GitHub 上发布我们的 项目。

> **Note:**
> 此功能依赖于 [GitHub](https://plugins.jetbrains.com/plugin/13115-github) 插件，您需要安装并启用它。 如需了解更多信息，请参阅 [打开插件设置](managing-plugins.html#open-plugin-settings)。

Procedure:

1. 在主菜单中，转到  `Git | GitHub | 在 GitHub 上共享项目`   `Git | GitHub | 在 GitHub 上共享项目` 。

2. 在打开的对话框中，您可以更改仓库名称（默认与 项目 名称相同）、远程名称（默认  `origin` ）、选择仓库类型（公开或私有），还可按需添加描述。

在   存储库名称   和   远程   字段中保留默认值。 选择   私有   选项。

如果尚未在 GitHub 注册，请点击   添加账户  ，然后点击   通过 GitHub 登录  。

![GitHub 上共享项目的对话框](https://resources.jetbrains.com/help/img/idea/2026.3/add_gh_account.png)

在弹出的浏览器窗口中输入您的 GitHub 凭据，或在那里创建一个新账户。 返回 CLion 后，   通过以下方式共享   字段将显示您的账户名称。

> **Tip:**
> 您可在  `设置 | 版本控制 | GitHub`  中通过令牌更改或添加 GitHub 帐户。 了解更多信息请参见 [管理多个 GitHub 帐户](set-up-a-github-account.html#manage_accounts)。

3. 点击   共享  。 项目成功发布到 GitHub 后，将出现以下通知：

![仓库已共享到 GitHub](https://resources.jetbrains.com/help/img/idea/2026.3/github_shared.png)

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

## 步骤 5。 创建一个新分支

在开发新功能且不希望更改直接影响主分支时，您可能需要创建一个新分支。

Procedure:

1. 按 `Ctrl+T` (Windows), `⌘ T` (macOS), `⌘ T` (IntelliJ IDEA Classic (macOS)), `⌘ T` (macOS System Shortcuts), `Ctrl+T` (XWin), `Ctrl+T` (GNOME), `Ctrl+T` (KDE), `Ctrl+T` (Emacs), `Ctrl+T` (Sublime Text), `Ctrl+T` (Sublime Text (macOS)), `⌘ ⌥ X` (Xcode), `Ctrl+Alt+W` (Visual Studio), `⌘ ⌥ W` (Visual Studio (macOS)), `Ctrl+Alt+W` (ReSharper), `⌘ ⌥ W` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `Ctrl+T` (QtCreator (macOS)), `Ctrl+T` (NetBeans), `Ctrl+T` (Eclipse), `Ctrl+T` (Eclipse (macOS))或转到   Git | 更新项目​​.  。 在打开的   更新项目   对话框中，保留默认合并选项。 点击   确定   以拉取当前分支的最新版本。

![更新项目对话框已打开](https://resources.jetbrains.com/help/img/idea/2026.3/git-update-project-popup.png)

2. VCS 微件显示您当前分支的名称 ——  `main` 。 点击它，在   本地   节点中选择  `main`  分支，然后点击   从“main”新建分支  。

![Git 分支菜单](https://resources.jetbrains.com/help/img/idea/2026.3/branch_menu.png)

3. 在打开的对话框中，指定分支名称（如  `new_feature` ），并选择   签出分支   选项以立即切换到新分支。

![新建 Git 分支](https://resources.jetbrains.com/help/img/idea/2026.3/new_branch.png)

> **Tip:**
> 如果当前分支存在未提交的更改，您必须先提交、还原或暂存这些更改，才能切换到其他分支。 了解更多信息请参见 [在分支之间切换](manage-branches.html#switch-branches)。

现在，您已切换到新创建的分支：

![已切换到新分支](https://resources.jetbrains.com/help/img/idea/2026.3/changed_branch.png)

## 步骤 6。 进行并查看更改

Procedure:

1. 向 项目 添加一个新文件（例如，  `git-features.md` ），当 CLion 建议将其添加到 Git 版本控制时，点击   Add  。

随后，打开  `README.md`  文件，并用新的描述替换原有内容：

```MARKDOWN
# 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` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 和编辑器选项卡中，CLion 对文件使用不同颜色：蓝色表示已修改，绿色表示新添加。 此外，在已修改文件的边距区域，彩色更改标记会出现在修改的行旁边。

![编辑器和项目工具窗口中的更改](https://resources.jetbrains.com/help/img/idea/2026.3/vcs_changes.png)

2. 如需查看具体更改内容，请点击行边标记：

![彩色更改标记](https://resources.jetbrains.com/help/img/idea/2026.3/change_marker.png)

若要在单独的编辑器选项卡中查看差异，请点击 ![显示差异图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   显示行差异  ：

![作用域差异](https://resources.jetbrains.com/help/img/idea/2026.3/diff_for_range.png)

3. 转到   提交   工具窗口 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))，以一次性预览所有更改。 双击文件以在编辑器中打开差异视图：

![本地更改](https://resources.jetbrains.com/help/img/idea/2026.3/local_changes.png)

了解更多信息请参见 [调查 Git 仓库中的更改](investigate-changes.html)。

## 步骤 7。 提交并推送更改

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

Procedure:

1. 在   提交   工具窗口 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) 中，勾选我们两个文件旁的复选框，并输入提交消息（例如  `Update README.md` ）。

在输入提交消息时，您可以对 项目 文件名使用 [自动补全](auto-completing-code.html)（ `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))）：

![提交消息中的自动完成](https://resources.jetbrains.com/help/img/idea/2026.3/commit_completion.png)

点击   提交  。

> **Tip:**
> 要撤销最新的未推送提交，请在   日志   标签的   Git   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 中右键点击该提交并选择   撤销提交  。 如需了解详情，请参阅 [撤销上一次提交](undo-changes.html#revert-last-commit)。

2. 按 `Ctrl+Shift+K` (Windows), `⌘ ⇧ K` (macOS), `⌘ ⇧ K` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ K` (macOS System Shortcuts), `Ctrl+Shift+K` (XWin), `Ctrl+Shift+K` (GNOME), `Ctrl+Shift+K` (KDE), `Ctrl+Shift+K` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌘ ⇧ K` (Sublime Text (macOS)), `Ctrl+Shift+K` (Xcode), `Ctrl+Shift+K` (Visual Studio), `⌘ ⇧ K` (Visual Studio (macOS)), `Ctrl+Shift+K` (ReSharper), `⌘ ⇧ K` (ReSharper (macOS)), `Ctrl+Shift+K` (QtCreator), `⌘ ⇧ K` (QtCreator (macOS)), `Ctrl+Shift+K` (NetBeans), `Ctrl+Shift+K` (Eclipse), `⌘ ⇧ K` (Eclipse (macOS)) 或从主菜单中选择  `Git | 推送`  将更改推送到远程仓库。   推送提交  对话框已打开。 在这里，您可以查看所有即将推送的提交，以及所有受影响的文件。

在推送更改之前，您可以查看每个文件的差异。 为此，右键点击文件并选择 ![显示差异图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   显示差异   或按 `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `⌘ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))：

![推送提交](https://resources.jetbrains.com/help/img/idea/2026.3/push_commits.png)

3. 点击   推送  。

之后，CLion 会将所有更改推送到 GitHub 上的远程仓库。

> **Tip:**
> 若要还原已推送的提交，请在   日志   标签的   Git   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 中右键点击该提交并选择   撤销提交  。 如需了解详情，请参阅 [恢复已推送的提交](undo-changes.html#revert-commit)。

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

您可以通过多种方式将更改从一个分支应用到另一个分支，例如合并和变基分支、挑拣提交、应用单独的更改或文件。 所有这些方法在 [合并、变基或挑拣以应用更改](apply-changes-from-one-branch-to-another.html) 中有详细说明。

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

Procedure: 合并分支

1. 在   [Git 分支](#git_branches_menu)   微件中选择  `main`  分支，然后点击   检出  。

> **Tip:**
> 如果当前分支存在未提交的更改，您必须先提交、还原或暂存这些更改，才能切换到其他分支。 了解更多信息请参见 [在分支之间切换](manage-branches.html#switch-branches)。

2. 在 [第 6 步](#changes) 中，我们在  `new_feature`  分支修改了  `README.md`  文件。 现在，在  `main`  分支中再次更新文本，以模拟合并冲突：

```MARKDOWN
# Tutorial

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

```

按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))，确保在此文本后于文件中创建新行，就像在 [步骤 2](#new-line-in-editor)中一样。 这样有助于我们后续解决冲突。

3. 如 [第 7 步](#commit_and_push) 中所述，提交并推送更改。 输入提交消息（例如  `Add information about Git tutorial` ）。

4. 在 VCS 微件的   本地   节点中，选择  `new_feature`  并点击   将“new_feature”合并到“main”  。

![VCS 微件菜单中的合并选项](https://resources.jetbrains.com/help/img/idea/2026.3/merge_into_main_option.png)

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

![冲突对话框](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts_dialog.png)

Procedure: 解决冲突

1. 在   冲突   对话框中，您有几种选项来解决冲突：

* 接受您的版本 保留当前分支中的更改。

* 接受他们的版本 应用您想要合并到当前分支的其他分支中的更改。

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

点击   合并  。   合并修订   对话框打开：

![解决冲突](https://resources.jetbrains.com/help/img/idea/2026.3/merge_revisions.png)

* 左侧窗格（称为 来自 main 的更改 ）显示来自本地副本的只读更改。

* 右侧窗格（称为 来自 new_feature 的更改 ）显示来自我们想要合并到 `main` 的 `new_feature` 分支的只读传入更改。

* 中间窗格（称为 结果 ）是一个具有冲突解决结果的全功能编辑器。

2. 在此对话框中，您可以点击 ![从左侧应用更改](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.applyNotConflictsLeft.svg)／ ![从右侧应用更改](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.applyNotConflictsRight.svg) 接受更改，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.remove.svg) 拒绝更改，并在中间的   结果   窗格中输入代码。 了解更多信息请参见 [解决 Git 冲突](resolve-conflicts.html)。

让我们通过点击 ![从左侧应用更改](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.applyNotConflictsLeft.svg) 接受左侧窗格中  `main`  的一个更改。 由于我们不需要来自  `new_feature`  的相同行的更改，因此在右侧窗格的红色冲突行中点击 ![移除](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.remove.svg) 将其丢弃。

在右侧窗格中点击 ![从右侧应用更改](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.applyNotConflictsRight.svg)，接受来自  `new_feature`  的其余未发生冲突的更改。

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

```MARKDOWN
# 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.

```

![冲突已解决](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts_resolved.png)

3. 点击   Apply  。

CLion 会将  `new_feature`  分支合并到  `main`  分支。

4. 通过按 `Ctrl+Shift+K` (Windows), `⌘ ⇧ K` (macOS), `⌘ ⇧ K` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ K` (macOS System Shortcuts), `Ctrl+Shift+K` (XWin), `Ctrl+Shift+K` (GNOME), `Ctrl+Shift+K` (KDE), `Ctrl+Shift+K` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌘ ⇧ K` (Sublime Text (macOS)), `Ctrl+Shift+K` (Xcode), `Ctrl+Shift+K` (Visual Studio), `⌘ ⇧ K` (Visual Studio (macOS)), `Ctrl+Shift+K` (ReSharper), `⌘ ⇧ K` (ReSharper (macOS)), `Ctrl+Shift+K` (QtCreator), `⌘ ⇧ K` (QtCreator (macOS)), `Ctrl+Shift+K` (NetBeans), `Ctrl+Shift+K` (Eclipse), `⌘ ⇧ K` (Eclipse (macOS)) 或从主菜单中选择  `Git | 推送`  将更改推送到远程仓库。

您可以在   Git   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 的   日志   标签页中查看所有分支的提交：

![Git 日志选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/git_log_tab.png)

从这里，您还可以还原提交、将更改从一个分支挑拣到另一个分支，以及更多操作。 有关详细信息，请参阅 [日志选项卡](log-tab.html)。

## 步骤 9。 查看历史记录

当您与他人共同处理 项目 时，您可能会想知道该文件为何、何时以及如何被更改。

Procedure:

在  `main`  分支中，打开  `README.md`  文件。 若要查明这些更改源自哪个提交，请执行以下操作之一：

* 在编辑器或   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中右键点击文件并选择  `Git | 显示历史` 。   历史记录   工具窗口的   Git   选项卡将打开：

![Git 文件历史记录](https://resources.jetbrains.com/help/img/idea/2026.3/git_history.png)

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

* 在编辑器中，选择您想要查看历史记录的代码片段，右键点击所选内容并选择  `Git | 显示所选内容的历史` 。 将打开   选定内容的历史记录   对话框：

![选定内容的 Git 历史记录](https://resources.jetbrains.com/help/img/idea/2026.3/history_for_selection.png)

在这里，您可以查看影响您感兴趣的代码选择的所有提交。

在 [调查 Git 仓库中的更改](investigate-changes.html) 中找到更多探索 Git 历史的方法。

## 总结

本教程中，您已学会如何：

* [创建项目](#create-test-prj)并带有本地 Git 仓库

* [将文件添加到 Git](#add-files-to-git) 并跟踪更改

* [提交更改](#add_to_git)以保存项目状态

* [在 GitHub 上共享您的项目](#github)

* [创建和切换](#new_branch)分支

* [合并分支](#merge)并 [解决冲突](#resolve)

* [查看并分析更改历史](#view_history)

## 后续步骤

如果您没有在本教程中找到如何执行某些特定的 Git 任务，请参阅 [Git](using-git-integration.html) 指南——IDE 中可用的所有 Git 操作都在其中进行了描述。

如果您的 项目 未受 Git 管理，您仍可使用 [本地历史记录](local-history.html) 功能跟踪并管理本地更改、回滚到特定文件状态、恢复已删除文件等。

