Git功能分支开发流程

以下流程适合个人项目或允许直接合并主分支的小型团队。团队项目如果要求Pull Request，应在推送功能分支后通过Pull Request合并，不要直接推送main。

1.创建功能分支

开发新功能前，先更新本地主分支，再基于主分支创建功能分支：

git switch main
git pull --ff-only origin main
git switch -c feature/user-module

--ff-only可以避免git pull自动创建不必要的合并提交。

2.提交代码

先检查改动，再按实际范围暂存文件：

git status
git add <文件路径>
git commit -m "feat: 完成用户登录接口"

确认所有改动都属于本次提交时，也可以使用git add .。

常见提交类型：

类型	用途
feat	新增功能
fix	修复问题
docs	修改文档
refactor	重构代码，不改变功能
test	新增或修改测试
chore	构建、依赖或辅助配置变更

3.临时切换任务

当前改动不适合提交，但需要临时切换分支时，可以暂存工作区：

git stash push -u -m "暂存用户模块开发"
git switch main

处理完临时任务后返回原分支并恢复改动：

git switch feature/user-module
git stash pop

恢复后先运行git status，确认是否存在冲突。

4.合并功能分支

功能开发和测试完成后，先提交所有改动。个人项目可以直接合并：

git switch main
git pull --ff-only origin main
git merge feature/user-module
git push origin main
git branch -d feature/user-module

如果远端主分支在开发期间发生变化，应先同步并解决冲突，再进行合并。团队项目通常改为推送功能分支：

git push -u origin feature/user-module

之后创建Pull Request，由代码审查和自动化检查决定是否合并。