说明
分支和版本
| 仓库 | 分支 | 版本 |
|---|---|---|
| 本地 | dev | local_dev_1 |
| 本地 | master | local_master_2 |
| 远程 | dev | remote_dev_3 |
| 远程 | master | remote_master_4 |
环境模拟,有dev和master两个分支,并且本地和远程的代码都不相同,需要解决冲突
顺序
顺序建议:先 dev 后 master。
bash
#dev同步
1、切换到本地 dev 分支,把远程 dev 同步到本地 dev。
2、解决 local_dev_1 与 remote_dev_3 的冲突。(此时本地dev代码为最新)
3、冲突解决并测试通过后,把 本地dev 推送到远程 dev(此时本地和远程dev代码一致且为最新)
#master同步
4、切换到本地master分支,把远程 master同步到本地master。
5、解决 local_master_2 与 remote_master_4 之间的冲突(此时本地local_master_2已包含远程remote_master_4的最新提交)
6、把本地 dev 合并到本地 master。解决本地dev 与本地master之间的合并冲突(此时本地 master 已包含 dev 的内容)
7、把本地 master 推送到远程 master(此时本地和远程master代码一致且为最新)
#master->dev同步
8、上线完成后,切换到本地 dev 分支,先确保本地 dev 与远程 dev 同步;
9、然后执行把已上线的远程 master 合回本地 dev,解决冲突并测试通过后,把本地 dev 推送到远程 dev。
命令行操作
bash
# ========== 0. 可选:操作前备份 ==========
git branch backup-dev # 备份当前本地 dev 分支
git branch backup-master # 备份当前本地 master 分支
# ========== 1. 切换到本地 dev 分支,把远程 dev 同步到本地 dev ==========
git checkout dev # 切换到本地 dev 分支
git status # 确认工作区干净,无未提交修改
git fetch origin # 获取远程最新引用,不自动合并
git merge origin/dev # 把远程 dev 合并到本地 dev;若分叉会产生合并提交
# ========== 2. 解决 local_dev_1 与 remote_dev_3 的冲突 ==========
git status # 查看哪些文件冲突(both modified)
# 手动编辑冲突文件,删除 <<<<<<< ======= >>>>>>> 标记,保留正确代码
git add <冲突文件1> <冲突文件2> # 把已解决冲突的文件标记为已解决
git commit # 完成本次 merge 合并提交;无冲突时 merge 已自动提交
# ========== 3. 测试通过后,把本地 dev 推送到远程 dev ==========
# 在本地执行项目测试命令,例如:npm test / mvn test / pytest
git push origin dev # 推送本地 dev 到远程 dev;merge 方式通常普通 push 即可
git status # 确认本地 dev 与远程 dev 已同步
# ========== 4. 切换到本地 master 分支,把远程 master 同步到本地 master ==========
git checkout master # 切换到本地 master 分支
git status # 确认工作区干净
git fetch origin # 再次获取远程最新引用
git merge origin/master # 把远程 master 合并到本地 master;可能产生冲突
# ========== 5. 解决 local_master_2 与 remote_master_4 的冲突 ==========
git status # 查看 master 分支上的冲突文件
# 手动编辑冲突文件,合并双方修改,删除冲突标记
git add <冲突文件1> <冲突文件2> # 标记冲突已解决
git commit # 完成 master 同步的合并提交
# ========== 6. 把本地 dev 合并到本地 master ==========
git merge dev # 在 master 分支上合并本地 dev;可能产生冲突
git status # 查看 dev 与 master 的合并冲突文件
# 手动编辑冲突文件,解决 dev 与 master 的差异
git add <冲突文件1> <冲突文件2> # 标记冲突已解决
git commit # 完成 dev 合并到 master 的提交
# ========== 7. 测试通过后,把本地 master 推送到远程 master ==========
# 在本地执行完整测试,确认待发布版本可用
git push origin master # 推送本地 master 到远程 master
# 如果 master 是生产受保护分支,不要直接 push,改为:
# git push origin master:release/你的发布分支名 # 推发布分支,然后发起 PR/MR
# 禁止:git push --force origin master # 绝对不要强推生产 master
# ========== 8. 上线完成后,切回 dev,确保本地 dev 与远程 dev 同步 ==========
git checkout dev # 切换到本地 dev 分支
git fetch origin # 获取远程最新引用
git merge origin/dev # 确保本地 dev 包含远程 dev 最新提交;通常为快进
git status # 确认本地 dev 与远程 dev 一致
# ========== 9. 把已上线的远程 master 合回本地 dev,测试后推送 ==========
git merge origin/master # 把已上线的远程 master 合并回本地 dev;可能产生冲突
git status # 查看 dev 与 origin/master 的冲突文件
# 手动编辑冲突文件,解决 dev 与生产 master 的差异
git add <冲突文件1> <冲突文件2> # 标记冲突已解决
git commit # 完成 master 合回 dev 的合并提交
# 在本地执行测试,确认 dev 仍可用
git push origin dev # 推送本地 dev 到远程 dev,完成 dev 与 master 内容对齐
项目关联
eclipse关联远程仓库
项目的Team没有同步的选项
出现这种情况,是因为你的 Eclipse 项目当前还没有和 Git(EGit 插件)正确关联,缺少 Git 元数据(Git Nature),导致 Eclipse 无法识别它是一个版本控制项目

选择 Team -> Share Project...。在弹出的对话框中,勾选 Git 并点击"Next"。接着在下一窗口选中你的 Git 仓库,点击 Finish 完成关联。


右键Team介绍

| 选项 | 作用 | 作用说明 | 补充备注 |
|---|---|---|---|
| Commit... | 提交代码 | 将本地工作区的修改提交到本地 Git 仓库。 | |
| Stashes | 暂存修改 | 把当前未提交的修改"藏"起来,使工作区回到干净状态。 | 用于切换分支或处理紧急任务,处理完后再恢复 |
| Push to origin | 推送到远程 | 将本地当前分支的新提交,推送到默认的远程仓库。 | 默认远程仓库名: origin。 |
| Fetch from origin | 获取远程分支信息 | 从远程仓库下载最新的提交记录,但不会自动合并到你当前的本地代码中。 | 只会更新分支信息,不会变更代码 |
| Push Branch 'master'... | 推送指定分支 | 明确将本地的 master 分支推送到远程。 |
推送到远程同名分支 |
| Pull | 拉取并合并 | 从远程仓库拉取最新代码,并自动合并到当前本地分支。 | 相当于 Fetch获取分支信息 + Merge合并分支 的组合 |
| Pull... | 自定义拉取 | 打开拉取配置窗口,允许你指定拉取的远程仓库、分支。 | 可在此配置拉取策略(如 Merge 或 Rebase)。 |
| Remote | 远程仓库管理 | 配置和查看远程仓库。 | 如添加新的远程仓库、修改 URL、查看远程分支列表等。 |
| Switch To | 切换分支/标签 | 切换分支,新建分支 | |
| Advanced | 高级操作 | 包含打标签(Tag)、清理(GC)、计算差异等不常用的高级 Git 操作。 | |
| Synchronize Workspace | 同步工作区 | 打开同步视图,对比本地工作区与远程仓库的差异。 | 可以精确查看哪些文件有冲突或需要提交。 |
| Merge Tool | 代码合并工具 | 调用可视化代码合并工具。 | 打开本地远程对比,左侧本地,右侧远程 |
| Merge... | 合并分支 | 将其他分支(或远程分支)的代码合并到当前分支中。 | 只是合并代码和提交记录,并不会删除分支 |
| Rebase... | 变基 | 将当前分支的提交"搬移"到另一个分支的最新提交之后。 | 使提交历史成为一条直线,历史记录更清晰。 |
| Reset... | 重置 | 将当前分支的 HEAD 指针回退到某个历史提交。 | 支持 Soft(保留代码)、Mixed、Hard(彻底丢弃代码)三种模式。 |
| Create Patch... | 创建补丁 | 将本地的未提交修改或历史提交导出为 .patch 文件。 |
方便通过邮件或文件分享给其他人。 |
| Apply Patch... | 应用补丁 | 将外部的 .patch 文件应用到当前项目中。 |
常用于接收别人代码修改的场景。 |
| Add to Index | 添加到暂存区 | 将选中的未追踪文件或修改过的文件加入 Git 暂存区。 | 相当于命令行 git add。 |
| Ignore | 忽略文件 | 将选中的文件或文件夹加入 .gitignore 文件。 |
让 Git 不再追踪它们的变化。 |
| Show in History | 查看历史 | 在 History 视图中打开并查看当前项目或分支的提交记录。 | 可以查看具体提交的差异和作者信息。 |
| Show in Repositories View | 在仓库视图显示 | 在 Git Repositories 视图中定位到当前项目。 | 方便管理整个仓库的结构。 |
| Disconnect | 断开连接 | 解除当前项目与 Git 仓库的关联。 | 注意 :这只会移除 Eclipse 的版本控制标记,不会删除本地的 .git 文件夹和代码文件。 |
图形化实操
文件内容
创建test.java,每个版本各不相同,内容分别为
java
//本地dev内容
String local_dev_1 = "local_dev_1";
//本地master内容
String local_master_2 = "local_master_2";
//远程dev内容
String remote_dev_3 = "remote_dev_3";
//远程master内容
String remote_master_4 = "remote_master_4";
1、dev 同步
1. 切换到本地 dev 分支,把远程 dev 同步到本地 dev
- 在项目上右键 → Team → Switch To → dev ,切换到本地
dev分支。 - 右键项目 → Team → Remote → Fetch... ,选择
origin,点击 Finish,先把远程最新提交拉到本地引用。 - 右键项目 → Team → Pull... (或直接 Pull),拉取并合并
origin/dev到当前本地dev。

2. 解决 local_dev_1 与 remote_dev_3 的冲突
Pull 后如果有冲突,Eclipse 会标记冲突文件。解决方式:
- 打开 Git Staging 视图 (Window → Show View → Git Staging),在 Unstaged Changes 中能看到红色冲突标记的文件。
- 右键冲突文件 → Team → Merge Tool ,进入三路合并视图:左侧是当前分支(HEAD),右侧是目标/远程版本,中间是最终结果编辑区。
- 在中间区域 把文件编辑成最终想要的样子,确保不再残留
<<<<<<<、=======、>>>>>>>标记,保存文件。 - 回到 Git Staging 视图 ,在 Unstaged Changes 中右键已解决的文件 → Add to Git Index ,文件会移动到 Staged Changes 区域。
- 所有冲突文件都 Add 后,在 Staged Changes 区域填写 Commit Message,点击 Commit,完成合并提交。
Result: Conflicting(结果:冲突)
Merge Input(合并输入):说明本地的提交(21f5499...)和远程拉下来的提交(1515402...)都修改了同一个文件(test.java),Git 无法自动决定保留哪一个。
你现在直接点击右下角的 Close 按钮即可。接下来,在 IDEA 中按照以下步骤解决冲突:

项目目录的红色感叹号!会显示冲突的文件。打开文件会看到冲突的部分


右键冲突文件 → Team → Merge Tool,进入三路合并视图:左侧是当前分支(HEAD),右侧是目标/远程版本,中间是最终结果编辑区。

-
Use the git pre-merged 'ours' version of conflicting files(默认选中)
完全丢弃远程的修改,直接使用你本地的版本。远程新拉下来的代码会被直接覆盖掉,容易丢失同事写的逻辑,平时慎选。
-
Use the working tree version of conflicting files (pre-merged by Git)
使用 Git 生成冲突标记后的工作区文件(包含 <<<<<<<、=======、>>>>>>> 标记)。这会把冲突标记原样写进代码,需要后续手动清除。
-
Use HEAD (the last local version) of conflicting files
把文件彻底重置回你上一次本地提交时的状态(HEAD),远程的变更同样会被丢弃。这和选项 1 类似,通常只在你希望彻底放弃远程改动时使用。


保存解决完冲突的本地代码
然后Add Index:"添加到暂存区" = "标记为已解决"
如果你希望保留刚才解决冲突后的代码,需要完成这次合并提交: 右键项目 → Team → Commit...

3. 把本地 dev 推送到远程 dev
- 右键项目 → Team → Push to origin (如果 upstream 已配置为
origin/dev);或 Team → Remote → Push... ,在对话框中选择本地dev→ 远程origin/dev,点击 Finish。 - 推送成功后,本地
dev与远程dev一致。

远程dev代码和本地dev代码相同

2、master 同步
4. 切换到本地 master 分支,把远程 master 同步到本地 master
- 右键项目 → Team → Switch To → master ,切换到本地
master。 - 右键项目 → Team → 修改文件→ commit,提交到本地仓库
- 右键项目 → Team → Pull... ,拉取并合并
origin/master到当前master。

5. 解决 local_master_2 与 remote_master_4 之间的冲突
操作方式与第2步完全相同:
- 冲突文件会出现在 Git Staging 视图的 Unstaged Changes 中。
- 逐个右键冲突文件 → Team → Merge Tool,在中间区域编辑最终结果,保存。
- 右键文件 → Add to Git Index,移动到 Staged Changes。
- 如果你希望保留刚才解决冲突后的代码,需要完成这次合并提交:填写 Commit Message,点击 Commit,完成本次 master 同步的合并提交。
6. 把本地 dev 合并到本地 master,解决合并冲突
- 确认当前仍在本地
master分支。 - 右键项目 → Team → Merge... ,在对话框中选择 Local → dev ,点击 Merge。
- 如果产生冲突,重复第2步的 Merge Tool → Add to Git Index → Commit 流程。
- 合并完成后,本地
master已包含dev的内容(此时仍在本地master分支)。

产生冲突


7. 把本地 master 推送到远程 master
- 右键项目 → Team → Push to origin ,或 Team → Remote → Push... ,选择本地
master→ 远程origin/master,完成推送。 - ⚠️ 如果 master 是生产受保护分支 :不要直接 Push 到
origin/master。应该先推到一个发布分支(如release/xxx),然后在 Git 平台发起 Pull Request / Merge Request,走评审和 CI/CD 后再合并。绝对不要在 Eclipse 中对生产 master 执行强制推送 (EGit 中也没有安全的--force-with-lease图形化对应,更应避开)。

3、master → dev 同步
8. 上线完成后,切换回 dev,先确保本地 dev 与远程 dev 同步
- 右键项目 → Team → Switch To → dev。
- 右键项目 → Team → Remote → Fetch... ,选择
origin,获取最新远程引用。 - 右键项目 → Team → Pull ,把
origin/dev的最新内容合并到本地dev,确保没有落后。
9. 把已上线的远程 master 合回本地 dev,解决冲突后,推送远程 dev
- 确保当前在本地
dev分支。 - 右键项目 → Team → Merge... ,在对话框中选择 Remote Tracking → origin/master ,点击 Merge 。这里合并的是已上线的远程 master(origin/master),不是本地 master。
- 如果产生冲突,重复 Merge Tool → Add to Git Index → Commit 的流程。
- 测试通过后,右键项目 → Team → Push to origin ,把本地
dev推送到远程dev。
