ShopTRAINING/feature_branch_workflow.md

功能分支开发与合并标准流程

本文档旨在说明一个标准、安全的功能开发流程，涵盖从创建分支到最终合并的完整步骤。

流程概述

1. 创建功能分支：基于主开发分支（如 lyf-dev）在远程仓库创建一个新的功能分支（如 lyf-dev-req0001）。
2. 同步到本地：将远程的新分支同步到本地，并切换到该分支进行开发。
3. 开发与提交：在功能分支上进行代码开发，并频繁提交改动。
4. 推送到远程：定期将本地的提交推送到远程功能分支，用于备份和协作。
5. 合并回主分支：当功能开发和测试完成后，将功能分支合并回主开发分支。

---

详细操作步骤

第一步：同步并切换到功能分支

当远程仓库已经创建了新的功能分支后（例如 lyf-dev-req0001），本地需要执行以下命令来同步和切换。

1. 获取远程最新信息：

   git fetch
   

   这个命令会拉取远程仓库的所有最新信息，包括新建的分支。

2. 创建并切换到本地分支：

   git checkout lyf-dev-req0001
   

   Git 会自动检测到远程存在一个同名分支，并为您创建一个本地分支来跟踪它。

第二步：在功能分支上开发和提交

现在您可以在 lyf-dev-req0001 分支上安全地进行开发。

1. 进行代码修改：添加、修改或删除文件以实现新功能。

2. 提交代码改动：

   # 添加所有修改过的文件到暂存区
   git add .
   
   # 提交改动到本地仓库，并附上有意义的说明
   git commit -m "feat: 完成用户认证模块"
   

   最佳实践：保持提交的粒度小且描述清晰，方便代码审查和问题回溯。

第三步：推送功能分支到远程

为了备份代码和进行团队协作，需要将本地的提交推送到远程仓库。

# 将当前分支 (lyf-dev-req0001) 的提交推送到远程同名分支
git push origin lyf-dev-req0001

第四步：合并功能到主开发分支 (lyf-dev)

当功能开发完毕并通过测试后，就可以准备将其合并回 lyf-dev 分支。

1. 切换到主开发分支：

   git checkout lyf-dev
   

2. 确保主开发分支是最新版本： 在合并前，务必先拉取远程 lyf-dev 的最新代码，以减少冲突的可能性。

   git pull origin lyf-dev
   

3. 合并功能分支： 将 lyf-dev-req0001 的所有改动合并到当前的 lyf-dev 分支。

   git merge lyf-dev-req0001
   

   • 如果出现冲突 (Conflict)：Git 会提示您哪些文件存在冲突。您需要手动打开这些文件，解决冲突部分，然后再次执行 git add . 和 git commit 来完成合并提交。
   • 如果没有冲突：Git 会自动创建一个合并提交。

4. 将合并后的主分支推送到远程：

   git push origin lyf-dev
   

第五步：清理（可选）

当功能分支确认不再需要后，可以删除它以保持仓库整洁。

1. 删除远程分支：

   git push origin --delete lyf-dev-req0001
   

2. 删除本地分支：

   git branch -d lyf-dev-req0001
   

---

遵循以上流程可以确保您的开发工作流程清晰、安全且高效。