一个 JBoss 项目
Red Hat
主页 / 文档 / 操作指南 / 将 Git 与 IDE 结合使用

操作指南

将 Git 与 IDE 结合使用

该 IDE 包含 Git 视点，旨在让开发者能够通过图形界面快速轻松地创建、添加和管理其 Git 存储库。本文介绍了 Git 项目的基本工作流程，以及如何通过 Git 视点完成最常见的 Git 相关任务。基于 Git 的常见任务包括

  1. 设置 Git 视点

  2. 在 Git 视点设置一个存储库

  3. 为存储库添加一个远程存储库

  4. 创建并使用一个新的分支，其中包括

    1. 创建一个新的分支

    2. 在新分支中工作

    3. 在实现更改前更新分支

  5. 提交并合并更改

    1. 提交并推送更改

    2. 在不推送更改的情况下提交

设置 Git 视点

使用以下说明在 IDE 中找到 Git 视点

  1. 单击页面顶部菜单栏中的 窗口  视点  打开视点  其他。

  2. 从可用视点列表中选择 Git，然后单击 确定。

结果： Git 存储库 视图将显示在窗口的左上方。

1. 在 Git 视点设置一个存储库

在 IDE 中使用 Git 视点的第一步是设置一个 Git 存储库。有以下三种方式可以在 Git 视点设置一个 Git 存储库

对开发者而言，最常见的用例是克隆一个现有的存储库，或者将存储库的现有本地克隆导入到 IDE 中。不管怎样，第一个选项是一种从头开始创建完整存储库（裸存储库或普通存储库）的简单方法。

创建一个新的 Git 存储库

如果尚未创建并提供一个存储库，请使用以下步骤创建一个新的存储库

  1. 点击 创建新 Git 仓库并添加到该视图 按钮。

    Click the Create a New Git Repository Button
    图 1. 点击创建新 Git 仓库按钮

  2. 在对话框中

    1. 确保自动填充的 仓库目录 字段的默认值正确无误。

    2. 可选择（如有必要）选中 创建一个光秃秃的仓库 以创建一个新的光秃秃仓库。有关光秃秃仓库及其与普通仓库的不同之处的详情，请参阅 您知道吗？ 部分。

      Create a New Git Repository
      图 2. 创建新 Git 仓库

      结果：在新 Git 仓库中创建于本地计算机中，且显示在 Git 仓库 视图中。

克隆现有 Git 仓库

如果您的仓库在线已存在（例如，在 GitHub 上），请使用以下步骤创建一个本地克隆

  1. 确保您在线分叉了仓库。此选项在仓库主机的网站中提供。

  2. 点击 克隆 Git 仓库并将克隆添加到该视图 按钮。

    Click the Clone a Git Repository Button
    图 3. 点击克隆 Git 仓库按钮

  3. 如下输入源仓库的详情

    1. 添加仓库的在线源的 URI。此举自动填充 主机 和 仓库路径 字段。

    2. 在 身份验证 详情下添加源仓库的用户名和密码。

    3. 点击 下一步 以继续。

      Enter the Source Repository Details
      图 4. 输入源仓库详情

  4. 如下自定义 Git 仓库的本地版本

    1. 确认目的地 目录 和 初始分支 的自动填充信息已填写正确。

    2. 可选择为 远程名称 字段设置非默认名称。

    3. 可选择选中 将项目添加到工作集 选项，并使用下拉菜单和 选择 按钮为该仓库选择相应的工作集。

      Customize the Local Version of the Git Repository
      图 5. 自定义 Git 仓库的本地版本

    4. 点击 完成 以结束对现有 Git 仓库的克隆。

结果：新克隆的仓库显示在 Git 仓库 视图中。

添加现有本地 Git 仓库

如果您已在本地克隆了一个 Git 仓库，以下说明是向 IDE 添加 Git 仓库所必需的。如果您尚未克隆您的仓库，请遵循以下先决条件部分中的说明

先决条件

  1. 确保您在线分叉了仓库。

  2. 在本地系统的命令行中，导航到您想要存储仓库本地副本的位置，并输入以下命令以克隆仓库

    $ git clone ${repo_URL}

    ====添加现有 Git 仓库按照以下说明将现有本地 Git 仓库添加到 JBoss Developer Studio 的 Git 透视

  3. 单击 将现有本地 Git 仓库添加到此视图 按钮。

    Click the Add an Existing Local Git Repository Button
    图 6. 单击添加现有本地 Git 仓库按钮

  4. 按以下步骤选择本地 Git 仓库

    1. 单击 浏览 导航到包含 Git 仓库的本地目录。

    2. 可选择选中 查找嵌套仓库 复选框以搜索嵌套仓库。

    3. 在 搜索结果 框中，确保选择了适当的 .git 文件。

      Find and Add Local Repository
      图 7. 查找并添加本地仓库

    4. 单击 完成。

结果： 本地仓库现显示在 Git 仓库 视图中。

为仓库添加远程

首次设置仓库后，为仓库设置一个远程。这是新创建或添加的仓库的一次性设置步骤。

  1. 在 Git 仓库 视图中，展开目标仓库。

  2. 从扩展选项中，右键单击 远程，然后 创建远程。

  3. 在 新远程 对话框中

    1. 在 远程名称 字段中添加一个名称。

    2. 确保选中 配置推送 单选按钮。

    3. 单击 确定 以继续。

  4. 在 配置推送 对话框中

    1. 单击 更改 以查看 选择 URI 对话框。

    2. 在 URI 字段中添加仓库的 URI。这会自动填充 主机 和 仓库路径 字段。

    3. 在对话框的 身份验证 部分添加仓库用户名和密码，然后单击 完成 以继续。

  5. 单击 保存 保存推送配置设置。

结果： 展开仓库视图中的 远程 文件夹以查看新添加的远程。

2. 创建新分支并对其进行操作

本节提供有关创建新分支以及使用新分支执行常见任务的说明，例如

  1. 创建新分支

  2. 在新分支中工作

  3. 在实施更改前更新分支

创建新分支

如果仓库已设置在 IDE 中，可创建一个新分支来对文件进行更改。

  1. 在 Git 仓库 视图中

    1. 展开 Git 仓库的名称。

    2. 单击 分支 以展开分支视图。

    3. 单击 远程跟踪 以查看仓库的所有远程分支。

    4. 将显示一个以 origin/master 开头的名称的分支。右键单击此分支，然后从显示的选项中选择 创建分支。

      Create a Branch from Origin/Master
      图 8. 从 Origin/Master 创建分支

  2. 添加有关新分支所需的详细信息

    1. 在“分支名称”字段中添加所需的新分支名称。

    2. 确保选中“配置上游以进行推送和拉取”复选框。

    3. 在“进行拉取时”选项中，选择适合您要求的选项。“将上游提交合并到本地分支”选项会在发生合并时创建提交。这些提交包含在后续的拉取请求中。“将本地分支的提交变基到上游”选项会在添加您的更改之前执行变基，这会防止拉取请求中出现额外的提交。

    4. 确保选中“签出新分支”复选框。

      Add Details for a New Branch
      图 9. 添加新分支的详细信息

    5. 单击“完成”以创建新分支。

结果：新分支显示在 Repository_Name  Branches  Local 中。

在新分支中工作

创建新分支后，您可以按照如下方式在新分支中实现更改

  1. 展开 Repository_Name  Branches  Local 并找到需要实现更改的新分支。

  2. 确认已签出目标分支。当前签出的分支显示一个小黑勾

    An Example of a Checked-out Branch
    图 10. 签出分支的示例

  3. 右键单击签出的分支名称，并将在菜单中将鼠标悬停在“显示在”选项上，然后在子菜单中单击“终端”。

    The Show Branch in Terminal Option
    图 11. 显示分支在终端选项中的方式

  4. 在右侧视图中，出现一个“终端”选项卡。在同一行中，单击类似于计算机显示器的图标，在该视图中查看命令行提示符。

    The Open a Terminal Button
    图 12. 打开终端按钮

  5. 在“启动终端”对话框中

    1. 确保在“选择终端”下拉框中选择“本地终端”。

    2. 在“编码”框中选择“默认值 (ISO-8859-1)”。

    3. 单击“确定”。请注意，默认情况下，终端窗口位于**directory/home/YourCurrentUser/**中。

结果：“终端”选项卡现在显示命令行终端。使用终端视图对已签出的文件进行所需的更改。

实现更改之前更新分支

在本地某个分支上工作时，最好确保在创建拉取请求 (PR) 之前本地分支是最新的。例如，如果其他人已签出相同存储库并创建新分支、进行更改并合并更改，请使用以下过程更新您的存储库和分支，然后才能提交您自己的更改。

在下面的示例中，使用 IDE 创建了一个名为 TrackingID-1234 的新分支。假设其他人正在处理同一存储库，并创建了一个名为 NEWBRANCH 的新分支，对其进行了更改，然后将这些更改合并回存储库。本地分支 (TrackingID-1234) 现在已过期，因为它不包括 NEWBRANCH 中的更改。使用以下说明更新该分支

  1. 右键单击要更新的存储库的名称。

  2. 从显示的菜单中，单击Pull。

  3. 将出现一个状态菜单，其中显示拉取请求的进度。

  4. 拉取完成后，将出现一个Repository_Name 的拉取结果菜单，其中列出了获取和更新操作的结果。

  5. 单击OK以完成操作。

结果：存储库现在包含最更新版本的内容。

4. 提交和合并更改

在完成所有必需的更改后，提交这些更改，然后创建一个拉取请求。然后由存储库所有者评估拉取请求，并将其合并到存储库中或拒绝它。

  1. 确保表示当前分支的黑白刻度出现在存储库视图的Local文件夹中的正确工作分支中。

  2. 右键单击存储库的名称。在显示的菜单中，单击Commit选项。

  3. 在Commit Changes对话框中

    1. 在Commit message文本框中添加一条提交消息，描述提交中的更改。

    2. 确认自动填充的Author和Committer字段包含正确的姓名和电子邮件地址。

    3. 在Files区域中，使用git add命令添加的所有文件都将显示在该框中。选择每个文件旁边的复选框，以将其包括在提交中。请参阅您知道吗？部分，了解仅将一些已更改的文件包括在提交中。

      Add details to the Commit Changes Dialog Box
      图 13. 向“提交更改”对话框添加详细信息

    4. 单击Commit以创建新的提交（不创建拉取请求）或单击Commit and Push以同时提交更改并创建拉取请求。

在不推送更改的情况下进行提交

如果您在前一过程中选择Commit以提交更改但没有推送它们，请使用以下说明

  1. 操作完成后，存储库现在会领先一次提交。它以箭头和数字一表示，如屏幕截图中所示

    Git Repository Status
    图 14. Git 存储库状态

  2. 当您准备好创建拉取请求时，右键单击当前分支名称，然后单击Push Branch。

  3. 将出现一个自动填充的Push Branch Branch_Name对话框。确认设置是否正确。创建此分支时选定的设置将用于此步骤。单击Next以继续。

  4. 将出现一个对话框，要求提供存储库访问用户名和密码。

  5. 出现“推送确认”对话框。单击“完成”创建请求合并。如果需要，请再次提供存储库的用户名和密码。

  6. 操作完成时，将显示“推送摘要”对话框。单击“确定”关闭此对话框。

结果：已提交包含的更改，并为存储库所有者生成合并请求以供审核。

提交并推送更改

如果您在上一个过程中选择了“提交并推送”，请使用以下说明

  1. 将出现一个对话框，要求提供存储库访问用户名和密码。

  2. 操作完成后，存储库现在会领先一次提交。它以箭头和数字一表示，如屏幕截图中所示

    Git Repository Status
    图 15. Git 存储库状态

  3. 拉取请求经过评估并合并后，右键单击存储库，然后单击“拉取”手动更新存储库。

结果：生成一个拉取请求，存储库所有者可以对其进行审核。

您知道吗？

  • 裸存储库推荐用于中央存储库，但不用于开发环境。裸存储库与普通存储库的区别在于，它们不包含任何源文件的工作或检出副本。这可以防止在存储库中编辑文件并提交更改。此外，它们将存储库的 Git 修订历史存储在存储库的根文件夹中，而不是 .git 子文件夹中。

  • 在“提交更改”中选择要提交的文件时，您可以使用每个文件名旁边的复选框仅选择要包含在提交中的文件。未选中的文件不包含在提交中，并且在提交并创建拉取请求时无需执行其他操作来协调未提交的文件。

  • 如果需要在每个提交消息中添加更改 ID，请在“提交更改”对话框中单击右上角的最右侧图标，以向提交消息添加更改 ID。

返回顶部