教程：在 DataSpell 中开始使用 Git

1. 启动 DataSpell，然后在 欢迎 屏幕上点击 新建 Project。

2. 在打开的对话框中，选择 project 类型（在本教程中，我们只创建一个 空 Project ），指定 project 的名称（例如， gitdemo ），并提供位置路径。

   请选择 创建 Git 存储库 复选框。

   

   点击 创建。 新的 project 将在 DataSpell 中打开。

1. 在 工作区 工具窗口 Alt+1 中，选择 project 目录（gitdemo）。

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

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

   

   现在当您修改该文件时，DataSpell 会自动索引所有更改（换句话说，添加到 Git 暂存区 ），因此您无需手动操作。

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

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

   稍后我们将使用该文件学习如何解决合并冲突。

1. 在 Commit 工具窗口 Alt+0 中，通过单击文件旁边的复选框来选择要提交的文件。

2. 为您的第一次提交输入提交信息：

   

3. 点击 Commit。 DataSpell 在成功提交后会通知您：

   

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

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

2. 在打开的对话框中，您可以更改存储库名称（默认情况下与 project 名称相同）、远程名称（默认情况下为 origin），选择存储库类型（公开或私有），并在需要时添加一些描述。

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

   

   在打开的浏览器窗口中输入您的 GitHub 凭据，或在该处创建新账户。 返回 DataSpell 后， 共享方式 字段将显示您的账户名称。

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

   

   点击通知中的链接可在 GitHub 上打开该存储库。

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

2. Git 分支 弹出窗口显示当前分支名称 — main。 点击它，在 本地 节点中选择 main 分支，然后 从 'main' 创建新分支。

   

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

   

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

   

1. 向 project 添加一个新文件（例如， git-features.md ），当 DataSpell 建议将其添加到 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+1 和编辑器标签中，DataSpell 会对文件使用不同颜色：蓝色表示已修改，绿色表示新添加。 此外，在已修改文件的边距区域内，将显示带颜色的更改标记，位于被修改行旁边。

   

2. 要查看具体更改内容，请点击边距标记：

   

   要在单独的编辑器标签页中查看差异，请点击 ：

   

3. 转到 Commit 工具窗口 Alt+0 ，预览所有变更。 双击文件即可在编辑器中打开差异视图：

   

   详细内容请参阅 调查 Git 仓库中的更改。

1. 在 Commit 工具窗口 Alt+0 中，选中两个文件旁边的复选框，并输入提交消息（例如 Update README.md）。

   在输入提交消息时，您可以对 project 的文件名使用自动完成 Ctrl+Space：

   

   点击 Commit。

2. 按 Ctrl+Shift+K 或从主菜单中选择 Git | 推送 ，将更改推送到远程存储库。 推送提交 对话框打开。 在这里，您可以查看所有将要推送的提交及其影响的文件。 在推送更改前，您可以逐个查看每个文件的差异。 为此，请右键点击某个文件，然后选择 显示差异 ，或按下 Ctrl+D：

   

3. 点击 推送。

合并分支

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.

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

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

   

解决冲突

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

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

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

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

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

   

   • 名为 来自 main 的更改 的左侧窗格显示本地副本中的只读更改。

   • 名为 来自 new_feature 的更改 的右侧窗格显示来自我们希望合并到 main 的 new_feature 分支的只读传入更改。

   • 名为 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 | 推送 ，将更改推送到远程版本库。

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

• 在编辑器或 工作区 工具窗口中右键点击该文件 Alt+1 ，然后选择 Git | 显示历史。 将打开 Git 工具窗口的 历史记录 标签页：

  

  在该标签页中，您可以查看影响此文件的所有提交，并找出所关注的更改是在哪个提交中添加的。

• 在编辑器中选择您要查看历史记录的代码片段，右键点击该选择，然后选择 Git | 显示所选内容的历史。 将打开 所选内容的历史记录 窗口：

  

  在此窗口中，您可以查看对所选代码片段产生影响的所有提交。