教程：在 PhpStorm 中开始使用 Git

1. 启动 PhpStorm，并在 欢迎 屏幕上点击 新项目。

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

   请选择 创建 Git 版本库 复选框。

   

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

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

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

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

   

   现在，当您修改此文件时，PhpStorm 会自动索引所有更改（即将其添加到 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。 提交成功后，PhpStorm 会通知您：

   

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

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

2. 在打开的对话框中，您可以更改版本库名称（默认与项目名称相同）、远程名称（默认是 origin），选择版本库类型（公开或私有），并在需要时添加说明。

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

   

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

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

   

   点击通知中的链接，在 GitHub 上打开该版本库。

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

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

   

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

   

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

   

1. 向项目添加一个新文件（例如 git-features.md ），当 PhpStorm 提示将其添加到 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.

   在 Project 工具窗口 Alt+1 和编辑器选项卡中，PhpStorm 会为文件应用不同颜色：蓝色表示已修改、绿色表示新添加。 此外，在已修改文件的边距区域会显示颜色变更标记，标识出修改过的行。

   

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

   

   要在单独的编辑器选项卡中查看差异，请点击 ：

   

3. 前往 Commit 工具窗口 Alt+0 ，以预览所有更改。 双击某个文件以在编辑器中打开差异视图：

   

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

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

   输入提交消息时，可以使用项目文件名的自动补全功能 Ctrl+Space：

   

   点击 Commit。

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

   

3. 点击 推送。

合并分支

1. 在 main 分支中，在 Git 分支 弹出窗口中选择并点击 检出。

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 | 推送 ，将更改推送到远程代码库。

在 main 分支中，打开 README.md 文件。 要了解这些更改是在哪次提交中引入的，请执行以下操作之一：

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

  

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

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

  

  在此处，您可以查看影响感兴趣代码片段的所有提交。