环境准备与插件安装
打开Eclipse后,先检查是否自带Git支持。大多数新版Eclipse已经内置了EGit插件,可以在菜单栏点击窗口菜单下的首选项,查看版本控制列表里是否有Git选项。如果没有,说明需要手动安装。进入帮助菜单的选择软件更新,在搜索框输入EGit并勾选最新稳定版完成安装。重启Eclipse后,右键任意文件夹或项目,如果弹出导入Git仓库的选项,就说明插件已生效。建议提前把Git客户端安装在系统环境变量里,这样Eclipse才能调用底层的Git命令执行各项操作。
首次连接远程仓库
开始写代码前,得先把本地环境和远程服务器打通。在项目空白处右键选择导入Git仓库,粘贴GitHub或Gitee提供的克隆地址。如果是第一次拉取,Eclipse会提示输入账号密码或者SSH密钥。推荐使用SSH方式免密登录,先在终端生成密钥对,把公钥复制到平台设置里,再把私钥配置到Eclipse的凭证管理器中。克隆完成后,项目目录会出现一个隐藏的.git文件夹,代表版本控制已绑定成功。此时可以右键项目查看历史记录,确认当前处于主分支状态。
日常提交与同步工作流
写代码过程中最核心的动作就是暂存和提交。修改文件后,右键选择团队下的添加至版本库,被修改的文件图标会变成带加号的绿色标记,这表示已进入暂存区。接着右键点击暂存的文件,选择提交更改,在弹出的窗口里填写简洁明了的注释,比如修复登录接口报错或者新增用户模块。填完点确定后,文件就会生成快照记录。想要把改动同步给队友,必须执行推送操作,右键项目选择推送至上游,勾选需要推送的分支并提交。每次推送前建议先拉取一次,避免多人同时修改导致覆盖冲突。
分支管理与合并操作
大型项目通常不会直接在主分支上改代码,而是通过分支隔离风险。右键项目选择创建分支,输入新功能的名字比如featlogin,然后切换到该分支继续开发。所有改动都在这条独立路线上进行,不会影响主干代码。开发测试完毕后,切回主分支,右键选择合并,指定刚才的功能分支进行合并。如果两个分支修改了同一个文件的同一行,Eclipse会在资源管理器里标红显示冲突。双击冲突文件,界面会分成左右两部分,左边是当前代码右边是目标代码,手动选择保留哪段,保存后重新提交即可解决冲突。合并成功后记得删除临时分支保持仓库整洁。
常见问题与排错技巧
使用中经常遇到推送失败或者拉取中断的情况。最常见的是认证过期,去Eclipse的首选项里找到网络访问密码,把过期的凭证删掉重新输入新密码即可。如果不小心提交了错误代码,可以直接右键项目选择重置,选择硬重置或软重置来回滚到指定版本。遇到拉取时提示拒绝合并未提交的更改,说明本地有未保存的改动,要么先提交要么用stash命令隐藏起来再拉取。另外,大文件上传容易导致仓库臃肿,可以在项目根目录放个.gitignore文件,把日志文件编译产物和依赖库排除在外,能大幅提升同步效率。