EGit是Eclipse上的Git插件

1. EGit插件的简介

EGit是Eclipse上的Git插件，官方内容参看http://wiki.eclipse.org/EGit。

EGit is an Eclipse Team provider for Git. Git is a distributed SCM, which means every developer has a full copy of all history of every revision of the code, making queries against the history very fast and versatile. The EGit project is implementing Eclipse tooling for the JGit Java implementation of Git.

2. EGit插件的安装与基本配置

2.1. 安装前的基本环境需求

2.1.1. GitHub或BitBucket账号

在使用GitHub/BitBucket相关功能之前，需拥有一个GitHub（https://github.com）或BitBucket（https://bitbucket.org/）账号。

2.1.2. Git客户端安装与基本配置

在使用Git及安装EGit插件之前，需预先安装Git软件（在Window中可以通过msysgit进行安装，安装包下载地址：http://msysgit.github.io/）并配置好SSH及账户信息。
具体安装及配置请参照《Git安装教程》文件。
Git 各平台安装包下载地址为：http://git-scm.com/downloads

2.2. EGit插件的安装

新版本的Eclipse下载后一般都会提供Git插件，若是没有Git插件,可以再eclipse 的market里面搜索EGit插件安装，如果低版本的eclipse安装高版本的EGit插件会报错，建议尽量选择与Eclipse版本相符的EGit插件，或直接去eclipse官网下载一个最新的eclipse for j2ee。
因此在安装EGit插件之前，可以先检查一下Eclipse是否已经自带Git插件。如已经自带，则无需安装，直接进行配置即可。

具体检查或安装方式如下：

2.2.1. 查看Eclipse版本，Eclipse中是否已安装EGit插件

打开Eclipse菜单栏Help -> AboutEclipse，查看是否有EGit插件的图标。

如上图所示，如能看到EGit插件图标，说明当前Eclipse已安装好EGit插件，可以直接进入配置环节，不再安装。
如没有看到EGit插件图标，可以按照如下方式进行安装：

2.2.2. Egit插件的下载与安装

EGit需要eclipse授权，通过网页是无法下载egit的安装包的。因此EGit的下载及安装仍在Elipse程序中进行。
注意：一般market里面搜索到的EGit插件都是适合最新版本的eclipse，所以建议先打开（http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F）。该网页提供了对应版本的EGit，自己选择相应的版本。

在Eclipse工具栏依次打开eclipse→help→install new software→Add，Name栏中输入EGit，location栏中输入 http://download.eclipse.org/egit/updates-X.X.X ，点击OK进行下载。

下载完成后会自动开始安装，根据界面提示点击next即可。
安装完成后会提示重启eclipse，点击OK即可完成整个安装流程。

2.3. EGit的基本配置及属性定义

2.3.1. Git账号的配置

进入工具栏Window ->Preferences -> Team -> Git -> Configuration，点击Add Entry…，添加name和email，在将项目代码commit到Git时需要用到name和email信息。在点击AddEntry…弹出的对话框中，Key填user.name，Value填姓名信息，这是添加name信息，在添加email信息时，Key填user.email，Value填email地址。 配置效果如图：

2.3.2. 其他常用属性与配置

在工具栏Window ->Preferences -> Team -> Git -> Configuration中，可以查看或修改本地仓库路径等其他常用配置。

3. EGit的主要功能使用方法解析

3.1. 3.1 本地项目提交及远程仓库推送

3.1.1. 创建一个GitHub/BitBucket项目代码仓库（如已存在可跳过）

登录GitHub或BitBucket账号，点击“New repository”添加项目代码仓库。

在这里以GitHub为例，输入Repository name（建议与提交的项目名同名），Description（稍微描述一下此项目的主要功能），选Public（Private为收费私人项目；Public免费公开项目，即所发布的项目代码任何人都可以查看得到），最后点击Create repository，项目代码仓库创建完毕。

3.1.2. 将本地项目代码发布至本地Git仓库

选中要发布的项目，单击右键，Team -> Share Project，选择Git，点击Next。

勾选Use or create repository in parent folder of project，选中要发布的项目，点击Create Repository，点击Finish完成。

发布项目。鼠标选中要发布的项目，单击右键，Team -> Commit，填写Commit message（必填，即当前版本的更新事项），勾选全选，点击Commit提交。

注意：此时，仅是提交在本地Git，还需要Push才能提交到远程GitHub或Bitbucket仓库中（下一步）。

3.1.3. 将项目发布至GitHub/Bitbucket远程仓库

选中要发布的项目，单击右键，Team -> Remote -> Push。
粘贴URI，填写User和Password（即GitHub的账户名和密码），点击Next。

接下来点击Source ref的下拉框，选择即将更新的Branch(一般为master)，点击Add Spec，点击Finish，点击OK完成。

如下图所示，项目已成功Push到GitHub/BitBucket远程仓库。

3.1.4. 项目首次推送（push）需注意的问题

在本地进行commit操作将项目更新提交到本地Git仓库后，如项目首次推送至远程仓库，则需先将服务器端的更新pull到本地仓库进行合并（Merge），然后再进行push操作。

发布后的GitHub/BitBucket项目页面，可以很方便的看到提交的次数，每次提交的备注信息等，非常方便对代码的管理。

3.2. 历史记录及版本对比

3.2.1. 历史记录

Team -> Show in history命令可以查看版本历史提交记录。

3.2.2. 版本对比

点击“Compare Mode”可以选择对比模式。

3.3. 远程Git仓库的访问及远程GitHub项目导入本地

3.3.1. 下载GitHub项目代码至本地Git仓库（clone）

从GitHub中取得项目代码后，点击工具栏Window -> Show View -> Git -> GitRepositories，点击OK，调出Git Repositories视图。

在Git Repositories视图中，点击“clone”按钮，进入Clone Git Repository对话框。填写URI，User，Password，点击Next。

接下来选择即将保存的仓库分支（Branch）和本地保存路径，点击Finish。

至此，项目代码就被下载到指定目录下了，需要使用的时候通过Eclipse Import进来即可。

3.3.2. 导入Git仓库代码到Eclipse

如图示，在已知项目远程仓库url的情况下，通过Import方法即可导入项目到本地开发环境。