手动合并到主分支参考

本文用于记录两个相关仓库从功能分支合并到主分支的通用流程。示例只使用泛化名称,复制到公开笔记时按需替换路径和分支名。

适用场景

  • 功能已经开发完成,并且已经在测试或生产环境验证过。
  • 需要把前端仓库和后端仓库的功能分支同步合并到 master。
  • 两个仓库分别独立管理 Git 历史,需要分别检查、合并和推送。

合并前检查

先分别进入两个仓库,确认工作区干净:

bash 复制代码
cd <frontend-repo>
git status --short --branch

cd <backend-repo>
git status --short --branch

如果有未提交改动,先确认这些改动是否属于本次发布:

  • 属于本次发布:先提交到功能分支,再合并。
  • 不属于本次发布:先暂存到 stash,或切到新的临时分支保存。
  • 不确定来源:不要直接丢弃,先确认再处理。

拉取远端信息

分别获取远端主分支和功能分支:

bash 复制代码
cd <frontend-repo>
git fetch origin master <frontend-feature-branch>

cd <backend-repo>
git fetch origin master <backend-feature-branch>

检查本地 master 是否和远端一致:

bash 复制代码
git rev-list --left-right --count master...origin/master

输出 0 0 表示本地 master 与远端 master 一致。

检查功能分支相对 master 的提交数量:

bash 复制代码
git rev-list --left-right --count master...<feature-branch>

如果输出类似 0 69,表示 master 是功能分支祖先,可以使用 fast-forward 合并。

合并前端仓库

bash 复制代码
cd <frontend-repo>
git switch master
git merge --ff-only <frontend-feature-branch>

如果成功,会看到 Fast-forward。如果失败,说明不能快进合并,需要先检查是否有并行提交或冲突。

合并后端仓库

bash 复制代码
cd <backend-repo>
git switch master
git merge --ff-only <backend-feature-branch>

同样优先使用 --ff-only,这样主分支历史会保持线性,更容易回溯。

推送主分支

确认两个仓库合并成功后,分别推送:

bash 复制代码
cd <frontend-repo>
git push origin master

cd <backend-repo>
git push origin master

推送完成后,再确认主分支状态:

bash 复制代码
git status --short --branch
git log --oneline --decorate -5

如果不能 fast-forward

如果 git merge --ff-only <feature-branch> 报错,先不要强推。按下面顺序处理:

bash 复制代码
git fetch origin master <feature-branch>
git switch master
git pull --ff-only origin master
git merge <feature-branch>

如果出现冲突:

bash 复制代码
git status --short

打开冲突文件,保留正确内容后执行:

bash 复制代码
git add <resolved-files>
git commit
git push origin master

冲突处理完成后,建议至少运行一次项目自身的基础检查,例如类型检查、单元测试、构建或核心接口冒烟测试。

推荐核对清单

  • 工作区在合并前是干净的。
  • 本地 master 与 origin/master 一致。
  • 功能分支已经包含本次要发布的全部提交。
  • 前端仓库已合并到 master。
  • 后端仓库已合并到 master。
  • 两个仓库的 master 都已推送远端。
  • 如有数据库变更,已确认线上应该执行的是增量 SQL,而不是全新初始化 SQL。
  • 如有部署流程,已确认部署使用的是更新后的 master。

常用命令速查

bash 复制代码
git status --short --branch
git fetch origin master <feature-branch>
git rev-list --left-right --count master...origin/master
git rev-list --left-right --count master...<feature-branch>
git switch master
git merge --ff-only <feature-branch>
git push origin master
git log --oneline --decorate -5
相关推荐
一起学安全技术11 小时前
拆大模型 11|大模型面试拷问:12 问逐层拆
人工智能·ai·语言模型·面试·职场和发展·求职招聘
学无止境小袁同学1 天前
LangGraph 深度指南
语言模型·框架·agent·并发·上下文·langgraph·长期记忆
一起学安全技术1 天前
拆大模型 10|结构化输出:让模型返回数据,而不是一段话
人工智能·语言模型·json
Dawson Zhu3 天前
【分布式训练⑧】通信优化:NCCL、Ring AllReduce与计算通信重叠
人工智能·语言模型·架构·aigc·agi
Dawson Zhu5 天前
【分布式训练④】张量并行与序列并行:把单层参数切碎分到多张卡
人工智能·语言模型·架构·aigc·agi
如夏倾城5 天前
百度文心(容易被忽略的好用AI)使用方式
人工智能·python·百度·语言模型·dubbo
xiaoye-duck5 天前
《C++ 项目:手写大模型接入 SDK》会话模块整合:内存 SessionManager 与 DataManager 持久化联动
开发语言·数据库·c++·语言模型
syyjhchou5 天前
自己搭企业内部中转站,怎么让请求更容易命中缓存
人工智能·后端·语言模型·aigc
Dawson Zhu6 天前
Queen Planner深度解析:Agent竞争从模型时代进入系统时代
人工智能·语言模型·架构·aigc·agi
硅谷秋水6 天前
EgoHumanoid‑V2 方法分析
人工智能·机器学习·计算机视觉·语言模型·机器人