【git工具篇】Git 常用实战手册：从基础命令到分支冲突解决（开发实战版）

---

本文总结了 Git 在实际企业开发场景下的常用命令、分支合并原理、冲突解决步骤及团队协作的最佳实践，旨在帮助开发者提升版本管理效率。

前言：Git 是现代软件开发中不可或缺的版本管理工具。本文针对企业级开发中的实际场景，整理了一套高效、安全的 Git 操作指南，从基础命令速查到复杂冲突处理，助力开发者在团队协作中游刃有余。

⚡ 快速参考

• 适用场景：日常代码提交、多人协作分支合并、代码冲突处理、Fork 模式贡献。
• 核心结论 ：保持本地主分支最新（git pull）是避免冲突的最有效手段。
• 最简步骤：1. 同步主分支；2. 创建功能分支；3. 提交改动；4. 推送并创建 PR/MR。
• 必备代码 ：git pull origin main；git merge --no-ff；git checkout -b feature/xxx。
• 高危避坑：禁止在主分支（main/master）直接修改代码；推送前务必检查当前分支跟踪状态。

📚 学习目标

1. 掌握 Git 常用命令的高频使用场景。
2. 深刻理解分支合并的两种模式（Fast-forward vs Merge Commit）。
3. 能够独立解决代码合并过程中产生的冲突。
4. 熟悉公司项目仓库与个人 Fork 仓库的协作流程。

一、常用命令

1.1 常用命令速查（按频率排序）

操作	命令	说明
查看状态	git status	查看工作区、暂存区状态
查看分支	git branch -vv	查看本地分支及其上游跟踪情况
查看远程	git remote -v	查看 origin/myfork 等远程 URL
添加改动	git add .	将所有改动加入暂存区
提交代码	git commit -m "msg"	提交暂存区内容
首次推送	git push -u origin br	推送并设置上游跟踪
直接推送	git push	推送到已跟踪的远程分支
拉取合并	git pull origin main	从远程拉取并合并到当前分支
安全建支	git checkout -b f/x o/m	基于远程主分支创建新分支
切换分支	git checkout main	切换到已有分支
合并分支	git merge feature/xxx	合并功能分支到当前分支
删除分支	git branch -d f/xxx	删除本地已合并的分支
暂存修改	git stash	临时保存未提交的改动
历史查看	git log --oneline --graph	图形化查看提交历史

二、分支原理详解

2.1 分支合并原理

场景：功能分支合并回主分支

A
B
C: Main
D
E: Feature
M: Merge Commit

• 默认合并提交（Non Fast-forward）：当主分支有新提交时，合并会产生一个新的节点 M。M 拥有两个父节点（C 和 E），记录了完整的开发历史。
• 快进合并（Fast-forward）：若主分支无新提交，主分支指针直接移动到功能分支最新点，不产生新节点。
• 最佳实践 ：使用 git merge --no-ff 强制生成合并节点，保留清晰的分支演进线索。

三、冲突解决

3.1 分支冲突的解决步骤

当两个分支修改了同一个文件的同一位置时，Git 会提示冲突。

1. 触发冲突

git merge feature/xxx
# 系统提示：CONFLICT (content): Merge conflict in login.js

2. 定位与分析

使用编辑器（如 VS Code）查看冲突标记：

<<<<<<< HEAD
return true;        // 当前分支 (main) 的修改
=======
return false;       // 待合并分支 (feature) 的修改
>>>>>>> feature

3. 手动修复

删除冲突标记，修改代码为预期结果（如 return 'ok';），然后保存。

4. 完成提交

git add login.js
git commit -m "merge: resolve conflict in login.js"

四、场景应用

场景1：公司项目仓库协作（直连模式）

• 需求：有权限直接向公司仓库提交代码。
• 方案 ：
  1. git pull origin main 同步。
  2. git checkout -b feature/task 开发。
  3. git push -u origin feature/task 推送。
  4. 发起 GitLab/Gitee 的 Merge Request。

场景2：个人 Fork 仓库协作（开源/强管控模式）

• 需求：先推送到个人空间，再请求合并到公司主库。
• 方案 ：
  1. git remote add myfork [URL]（仅首次）。
  2. 基于 origin/main 创建分支。
  3. git push -u myfork feature/task 推送到个人库。
  4. 在平台发起 Pull Request 合并到 origin。

五、开发避坑总结

1. 问题 ：代码推送失败，提示 rejected。
   原因 ：远程分支已有新提交，本地落后。
   解决 ：先 git pull 合并远程改动，解决冲突后再推送。
2. 问题 ：在错误的分支上写了一堆代码。
   原因 ：由于忘记切换分支。
   解决 ：执行 git stash 暂存，切换到正确分支后 git stash pop。
3. 问题 ：合并时产生大量不必要的冲突。
   原因 ：功能分支生命周期太长，长期未同步主分支。
   解决 ：定期在功能分支执行 git merge main。

六、总结

养成"先同步、后开发、勤提交、查状态"的习惯是 Git 进阶的必经之路。推送前执行一次 git check（见附录别名配置），确保万无一失。下一步，可以探索 Git Hooks 自动化校验或更高级的分支管理策略（如 GitFlow）。

本文为MY_TRUCK原创实战学习笔记，持续更新Java后端与工具实战干货，问题欢迎评论区交流。