教程：在 WebStorm 中开始使用 Git

1. 启动 WebStorm，然后在 欢迎 屏幕上点击 新建项目。

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

   选择 创建 Git 仓库 复选框。

   

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

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

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

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

   

   现在，当您修改此文件时，WebStorm 会自动索引任何更改（换句话说，将其添加到 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. 在 提交 工具窗口 Alt+0 中，选中要提交的文件旁的复选框。

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

   

3. 单击 提交。 提交成功后，WebStorm 会通知您：

   

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

1. 在主菜单中，依次选择 Git | GitHub | 在 GitHub 上共享项目。

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

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

   

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

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

   

   单击通知中的链接，在 GitHub 上打开仓库。

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

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

   

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

   

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

   

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

   

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 步 中，我们修改了 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。

   • 中间窗格（名为 结果 ）是一个功能完备的编辑器，显示已解决冲突的结果。

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 | 显示选定内容的历史记录。 将打开 所选内容的历史记录 窗口：

  

  在此处，您可以查看影响所选代码的所有提交。