1. 概述

本文将深入探讨 EGit —— Eclipse 平台上基于 JGit 库开发的 Git 集成工具。作为 Java 开发者,掌握 EGit 能显著提升在 Eclipse 中的版本控制效率。

2. EGit 设置

本文演示环境:

  • Eclipse Neon.3 (4.6.3)
  • EGit 插件 4.8 版本

2.1. 在 Eclipse 中安装 EGit

从 Eclipse Juno 版本开始,EGit 已内置集成。对于旧版 Eclipse,可通过以下步骤安装:

  1. 打开 Help -> Install New Software
  2. 输入更新地址:http://download.eclipse.org/egit/updates
  3. 按提示完成安装

安装 EGit

2.2. 设置提交者身份

Git 需要记录每次提交的操作者信息,因此必须配置用户身份:

  1. 进入 Preferences -> Team -> Git -> Configuration
  2. 点击 Add Entry 添加以下配置:
    • user.name: 你的姓名(如:张三)
    • user.email: 你的邮箱(如:[email protected])

配置身份

⚠️ 踩坑提示:未正确配置身份会导致提交记录显示为 "Unknown",影响团队协作。

3. 仓库管理

3.1. 仓库视图

EGit 提供的仓库视图支持以下核心操作:

  • 浏览本地仓库
  • 添加/初始化本地仓库
  • 删除仓库
  • 克隆远程仓库
  • 检出项目
  • 分支管理

打开路径:Window -> Show View -> Other -> Git -> Git Repositories

仓库视图

3.2. 创建新仓库

创建本地仓库的简单粗暴方法:

  1. 右键项目选择 Team -> Share Project
  2. 点击 Create
  3. 指定仓库目录后点击 Finish

创建仓库

3.3. 克隆仓库

从远程 Git 服务器克隆仓库到本地:

  1. File -> Import… -> Git -> Projects from Git
  2. 选择 Clone URI 粘贴仓库地址
  3. Git 会自动识别协议(https/ssh/git)并填充信息

克隆仓库

技巧:也可在仓库视图中直接点击 Clone Remote Repository 工具栏按钮。

4. 分支操作

Git 分支分为两类:

  • 本地分支(Local branch)
  • 远程跟踪分支(Remote tracking branch)

4.1. 创建本地分支

两种创建方式:

  1. 右键项目:Team -> Repository -> Switch to -> New Branch
  2. 仓库视图右键分支:Switch To -> New Branch

创建分支

⚠️ 关键操作:创建时勾选 Configure upstream for push and pull 可简化后续同步操作。

4.2. 切换分支

切换分支的两种途径:

  1. 仓库视图右键分支:Check Out切换分支1
  2. 右键项目:Team -> Switch To -> 选择分支名切换分支2

5. 文件跟踪与变更

5.1. 跟踪新文件

未跟踪文件会显示 ❓ 标记:

  1. 右键文件选择 Team -> Add to Index
  2. 文件标记变为 ✅ 表示已加入暂存区

5.2. 提交变更

提交已跟踪文件的变更:

  1. 右键文件选择 Team -> Commit
  2. 填写提交信息(必填)
  3. 可选点击 Add Signed-off-by 添加签名标签

提交窗口

最佳实践:提交信息应清晰描述变更内容,避免模糊表述如 "update code"。

5.3. 查看历史

查看文件变更历史:

  1. 右键文件:Team -> Show in History
  2. 历史窗口显示所有提交记录历史记录
  3. 双击文件名可打开比较视图:比较视图

5.4. 推送到远程仓库

推送本地变更到远程仓库:

  1. 右键项目:Team -> Remote -> Push
  2. 输入远程仓库 HTTPS 地址
  3. 执行以下步骤:
    • 选择 Add All Branches Spec 映射分支
    • 预览变更文件列表
    • 点击 Finish 完成推送

推送操作

效率提示:若在 4.1 节已配置上游分支,后续推送将跳过配置步骤。

5.5. 从上游获取更新

获取远程仓库最新变更:

  1. 右键项目:Team -> Fetch from Upstream
  2. 或在仓库视图右键仓库:Fetch from Upstream

自定义获取配置: Team -> Remote -> Configure Fetch from Upstream

配置获取

5.6. 比较与同步

比较工作目录与提交差异:

  1. 右键资源:Compare With
  2. 打开同步视图浏览变更同步视图
  3. 双击文件打开比较编辑器

比较两个提交的差异:

  1. Team -> Show in History
  2. 选中两个提交记录
  3. 选择 Compare with Each Other

提交比较

5.7. 合并分支

将其他分支变更合并到当前分支:

  1. 右键项目:Team -> Merge
  2. 或仓库视图右键仓库:Merge
  3. 选择要合并的分支或标签

合并操作

⚠️ 冲突处理:合并冲突需手动解决,Eclipse 会提供可视化工具辅助操作。

6. 总结

本文系统介绍了 EGit 插件的核心功能:

  • ✅ 安装配置与身份设置
  • ✅ 仓库创建与克隆
  • ✅ 分支管理全流程
  • ✅ 文件跟踪与变更提交
  • ✅ 远程同步与冲突处理

作为 Eclipse 用户的 Git 集成方案,EGit 提供了图形化操作界面,显著降低了版本控制的学习成本。更多高级功能可参考官方文档

实战建议:对于大型项目,建议结合命令行操作处理复杂场景,EGit 作为日常变更的可视化补充工具更高效。


原始标题:Introduction to EGit