教程：在 PyCharm 中开始使用 Git

1. 启动 PyCharm ，然后在 欢迎界面 的左侧窗格中点击 新建 | 项目。

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

   选择 创建 Git 仓库 复选框。

   

   点击 创建。 新的 项目 将在 PyCharm 中打开。

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

2. 在工具窗口工具栏上点击 ，并从列表中选择 文件。 将该文件命名为 README.md。

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

   

   现在，当您修改此文件时，PyCharm 会自动为任何更改建立索引（换句话说，将其添加到 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.

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

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

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

   

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

   

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

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

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

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

   

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

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

   

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

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

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

   

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

   

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

   

1. 向 项目 添加一个新文件（例如， git-features.md ），当 PyCharm 建议将其添加到 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 和编辑器选项卡中，PyCharm 对文件应用不同的颜色：蓝色表示已修改，绿色表示新添加。 此外，在已修改文件的边距区域，彩色更改标记会出现在修改的行旁边。

   

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

   

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

   

3. 转到 提交 工具窗口 Alt+0 ，以一次性预览所有更改。 双击文件以在编辑器中打开差异视图：

   

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

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

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

   

   点击 提交。

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 分支的只读传入更改。

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

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. 通过按 Ctrl+Shift+K 或从主菜单中选择 Git | 推送 将更改推送到远程仓库。

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

• 右键点击编辑器或 项目 工具窗口 Alt+1 中的文件并选择 Git | 显示历史记录。 Git 工具窗口的 历史记录 选项卡将打开：

  

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

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

  

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