Git单分支与多分支的协作流程

一、先理解 Git 在做什么

如果要用一句话概括，那就是：Git 是一个版本管理工具，用来记录代码的每一次变化。

这张图清晰地展示了单分支与多分支两种协作模式的核心差异，理解这一点，后续的流程就顺理成章了。

二、第一次使用 Git，要先做的两件事

1）配置用户名和邮箱

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

这两个信息至关重要，它们会作为“签名”写入每一次提交记录，方便团队追溯每一行代码的修改来源。

2）查看配置是否生效

git config --list

执行一下，确认配置已正确写入，这是后续所有操作的基础。

三、两种开始方式：clone和init

方式 A：拉取远程已有项目

git clone <仓库地址>

这是最常见的入门场景，比如参与一个开源项目：

git clone https://github.com/your-org/your-repo.git

命令执行后，项目代码连同完整的 Git 历史就都到本地了。

方式 B：本地新项目

git init

如果你是从零开始一个新项目，只需在当前目录执行这条命令，一个全新的 Git 仓库就初始化完成了。

四、场景一：单分支协作（直接在团队分支上开发）

这种模式在小团队或内部项目中很常见：所有人都在同一个长期分支（比如 dev）上直接协作。

目标

目标很明确：拿到仓库，拉取最新代码，完成一个小需求并提交上去。

推荐流程

第 1 步：先查看当前有哪些分支

git branch -a

知己知彼，先看看整个项目的分支布局。

第 2 步：切换到团队分支并拉取最新代码，避免“在旧代码上开发”

git switch dev
git pull origin dev

这是黄金法则。在开始编码前，务必确保你的起点是最新的，能避免大量无谓的冲突。

第 3 步：暂存并提交

git add .
git commit -m “feat: 完成登录页按钮交互优化”

提交信息尽量清晰，用前缀（如 feat, fix）说明变更类型，方便日后查阅。

第 4 步：推送到远程团队分支

git push origin dev

至此，你的改动就安全地同步到了远程仓库。

单分支场景的关键提醒

• 务必养成“先 pull 再开发”的习惯，这能省去很多麻烦。
• 切忌长时间不拉取最新代码，否则后续的合并冲突可能会变得非常棘手。

五、场景二：多分支协作（主流团队工作流）

这是更规范化的团队工作流：main/master 分支始终保持稳定可发布状态，每个新功能或修复都在独立的分支上完成，经过评审后再合并回主干。

目标

从主干获取最新代码，创建属于自己的功能分支，完成开发后，将其合并回目标分支。

推荐流程

第 1 步：先更新主干代码

git switch main
git pull origin main

同样，基于最新的主干创建分支，是良好实践的开始。

第 2 步：创建并切换到功能分支

git switch -c feature/login-form

分支名最好能体现业务语义，比如加上 feature/、fix/、docs/ 这样的前缀，一目了然。

第 3 步：暂存并提交

git add .
git commit -m “feat: 新增登录表单校验逻辑”

一个完整的功能可以拆分成多个逻辑清晰的小提交，这样代码审查和问题回滚都会方便得多。

第 4 步：推送分支并建立远程跟踪

git push -u origin feature/login-form

这里的 -u 参数是关键，它建立了本地分支与远程分支的跟踪关系，之后在这个分支上直接 git push 就可以了。

第 5 步：合并代码（两种常见方式）

方式 A（推荐）：在 GitHub、GitLab 等代码平台上发起 Pull Request 或 Merge Request，经过同伴评审后再合并。这是保障代码质量的标准流程。

方式 B（本地演示）：如果需要在本地演示合并过程，可以这样操作：

git switch main
git pull origin main
git merge feature/login-form
git push origin main

第 6 步：合并完成后清理分支

git branch -d feature/login-form
git push origin --delete feature/login-form

功能已经成功合并，本地和远程的临时分支就可以清理掉了，让分支列表保持清爽。

六、两个场景都通用的常见问题

1）pull或merge冲突了

这通常意味着同一段代码被不同的人修改了。别担心，解决方法很直接：打开冲突文件，手动决定保留哪部分内容（或进行整合），然后执行 add 和 commit 来完成这次冲突解决。

2）常见撤销操作（建议记住这 3 条）

# 取消暂存（把文件从暂存区放回工作区）
git restore --staged <文件>

# 丢弃工作区改动（针对单个文件，危险操作，谨慎使用）
git restore <文件>

# 丢弃当前目录所有未暂存的改动
git restore .

3）当前改动没做完，但要临时切走处理其他事情

git stash
git switch 其他分支
# 处理完回来
git switch 原分支
git stash pop

stash 命令就像一个临时储物箱，可以把进行到一半的工作现场保存起来，等你回来再原样恢复，非常实用。

七、总结：先练熟“场景流程”，再背命令

说到底，最重要的不是死记硬背每一个 Git 命令，而是彻底理解并跑通完整的协作流程。

• 单分支流程：branch -a -> switch/pull -> 开发 -> add/commit -> push
• 多分支流程：main pull -> 新建分支 -> 开发提交 -> push 分支 -> 合并 -> 清理分支

当你把这两套核心流程变成肌肉记忆后，再去探索 rebase、cherry-pick 这些进阶操作，就会觉得水到渠成，轻松很多了。