DataGrip 2025.2 Help

教程:在 DataGrip 中开始使用 Git

本教程将引导您完成最常用的 Git 操作,并展示如何在 DataGrip 中执行这些操作。 您将学习如何从项目创建 Git 仓库、将其共享到 GitHub、提交并推送更改、创建和合并分支、解决合并冲突以及查看文件历史记录。

步骤 1。 使用 Git 仓库创建新项目

在本教程中,我们将创建一个简单的项目,将其共享到 GitHub,并执行以下描述的一些 Git 任务。

  1. 启动 DataGrip,然后在 欢迎 屏幕上点击 新建项目

  2. 在打开的对话框中,选择项目类型(本教程中,我们将仅创建一个 空项目 ),指定项目名称(例如, gitdemo ),并提供位置路径。

    请选择 创建 Git 仓库 复选框。

    新建项目对话框

    点击 创建。 新项目将立即在 DataGrip 中打开。

您将收到通知,告知已为您的项目创建了本地 Git 仓库。 您将收到提示,表示已为项目创建本地 Git 仓库。同时,适用于 Git 的专用工具窗口也会可用。

Git 集成已启用
  1. Git 分支 弹出菜单: 管理 Git 分支并执行基本 Git 操作。

  2. Commit 工具窗口(Ctrl+K视图 | 工具窗口 | 提交): 查看本地更改并将其 提交到本地 Git 仓库。

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

步骤 2。 将文件添加到 Git

启用 Git 集成后,DataGrip 会显示已修改的文件、新添加到 Git 的文件,以及未被 Git 跟踪的文件。

为了解其工作原理,我们将创建一个简单的 README.md 文件并添加简要描述,再将其添加到 Git。

  1. 个文件 工具窗口 Alt+2 中,选择项目目录(gitdemo)。

  2. 点击工具窗口工具栏中的 ,然后在列表中选择 File。 将文件命名为 README.md

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

    将新文件添加到 Git

    现在,每当您修改该文件时,DataGrip 会自动为更改建立索引(换句话说,将其添加到 Git 暂存区 ),因此无需手动操作。

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

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

    稍后我们将使用它来学习如何解决合并冲突。

现在,新文件已被 Git 跟踪,并添加到了 Changes 更改列表中,可在 Commit 工具窗口 Alt+0 中查看。

更改列表中包含新创建的文件

Changes 更改列表帮助您管理尚未提交到 Git 仓库的本地更改。 了解更多信息请参见 将更改分组到changelist中

此外还有 未版本化文件 更改列表,列出了属于您项目但尚未添加到 Git 仓库的文件。 本教程不会涉及这些文件,但您可以在 将文件排除在版本控制之外(忽略) 中了解关于非版本控制文件的更多信息。

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

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

  1. Commit 工具窗口 Alt+0 中,通过选中复选框选择要提交的文件。

  2. 为您的第一次提交输入消息:

    Commit 工具窗口中的提交信息
  3. 点击 Commit。 提交成功后,DataGrip 会通知您:

    文件已提交通知

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

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

若要使您的项目可供其他协作者使用,您需要将其发布到远程仓库,例如在 GitHubGitLab 上。 DataGrip 提供对这两个平台的集成支持。 详细信息请参阅 管理托管在 GitHub 上的项目管理托管在 GitLab 上的项目

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

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

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

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

    “共享项目至 GitHub”对话框

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

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

    仓库已共享到 GitHub

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

步骤 5。 创建一个新分支

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

  1. Ctrl+T 拉取当前分支的最新版本。

  2. Git 分支 弹出菜单中显示您当前所在的分支名称 ——main。 点击该名称,在 本地 节点中选择 main 分支,然后点击 从 'main' 创建新分支

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

    新建 Git 分支

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

    已切换到新分支

步骤 6。 进行并查看更改

  1. 向项目中添加新文件(例如 git-features.md ),当 DataGrip 建议将其添加到 Git 版本控制时,点击 Add

    随后,打开 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+2 和编辑器选项卡中,DataGrip 对文件应用不同的颜色:蓝色表示已修改,绿色表示新添加。 此外,在已修改文件的边距区域,彩色更改标记会出现在修改的行旁边。

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

    彩色更改标记

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

    作用域差异
  3. 转到 Commit 工具窗口 Alt+0 ,预览所有更改。 双击文件以在编辑器中打开差异视图:

    本地更改

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

步骤 7. 提交并推送更改

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

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

    在输入提交消息时,您可以使用项目文件名的自动完成功能 Ctrl+Space

    提交消息中的自动完成

    点击 Commit

  2. Ctrl+Shift+K 或从主菜单中选择 Git | 推送 将更改推送到远程仓库。 推送提交 对话框打开。 在此处,您可以查看所有待推送的提交以及受影响的文件。 在推送更改之前,您可以查看每个文件的差异。 为此,右键点击一个文件并选择 显示差异 或按 Ctrl+D

    推送提交
  3. 点击 推送

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

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

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

合并分支

  1. Git 分支 弹出窗口中选择 main 分支,然后单击 检出

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

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

    按照 第 7 步 中的说明提交并推送更改。

  3. Git 分支 弹出窗口中的 本地 节点中,选择 new_feature 并单击 将 'new_feature' 合并到 'main'

    分支弹出菜单中的合并选项

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

冲突对话框

解决冲突

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

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

    • 接受对方的更改 用于应用您希望合并到当前分支的分支中的更改。

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

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

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

    • 右侧窗格名为 来自 new_feature 的更改 ,显示来自 new_feature 分支的只读传入更改,该分支将被合并到 main 中。

    • 中央窗格名为 Result ,是具备完整功能的编辑器,用于显示冲突解决结果。

  2. 在该对话框中,您可以通过单击 从左侧应用更改/从右侧应用更改 来接受更改,或单击 拒绝更改,也可以在中间的 Result 窗格中编写代码。 了解更多信息请参见 解决 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.
    冲突已解决

    点击 Apply

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

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

Git 日志选项卡

在此页面,您还可以还原提交、从一个分支中拣选变更到另一个分支等等。详见 日志选项卡

步骤 9。 查看历史记录

当与他人协作开发项目时,您可能会想知道文件被更改的原因、时间和具体方式。

main 分支中,打开 README.md 文件。 要找出这些更改是在哪一次提交中引入的,请执行以下任一操作:

  • 右键点击编辑器或 个文件 工具窗口 Alt+2 中的文件并选择 Git | 显示历史历史记录 标签页将在 Git 工具窗口中打开:

    Git 文件历史记录

    在该标签页中,您可以查看对该文件有影响的所有提交,并找出感兴趣的更改是在哪一次提交中添加的。

  • 在编辑器中,选择您想要查看历史记录的代码片段,右键点击所选内容并选择 Git | 显示所选内容的历史选定内容的历史记录 窗口将打开:

    选定内容的 Git 历史记录

    在这里,您可以查看影响您感兴趣的代码片段的所有提交。

调查 Git 仓库中的更改 中找到更多探索 Git 历史的方法。

接下来是什么

如果您没有在本教程中找到如何执行某些特定的 Git 任务,请参阅 Git 指南——IDE 中可用的所有 Git 操作都在其中进行了描述。

如果您的项目未受 Git 管理,仍然可以使用 本地历史记录 功能来跟踪和管理本地更改、回滚到特定文件状态、恢复已删除文件等。

最后修改日期: 2025年 9月 26日