Git协作规范

📝 Git 协作规范文档

📌 一、分支策略

为了保证代码质量和多人协作效率，采用如下分支结构：

🚧 二、分支命名规范

保持语义化、统一的分支命名方式：

feature/login
feature/article-edit
bugfix/form-validation
hotfix/server-crash
release/v1.2.0

🛠️ 三、开发流程

✅ 功能开发流程

1. 从最新的 dev 分支拉出自己的功能分支：

   git checkout dev
   git pull origin dev
   git checkout -b feature/xxx
   

2. 提交开发代码（建议提交频繁，描述清晰）：

   git add .
   git commit -m "feat: 实现 xxx 功能"
   

3. 开发过程中保持更新，避免分叉太远：

   git pull --rebase origin dev
   

4. 功能完成后，合并回 dev：

   git checkout dev
   git pull origin dev
   git merge feature/xxx
   git push origin dev
   

📦 四、提交规范

使用 Conventional Commits 格式，统一规范如下：

示例：

git commit -m "feat: 添加用户登录功能"
git commit -m "fix: 修复表单提交失败的问题"

🧪 五、合并规范

• 所有合并前必须 本地测试通过
• 优先使用 pull --rebase 解决分叉，提交记录更干净
• 合并分支需经过 code review（使用 Pull Request 或 Merge Request）
• 合并到 master 需由负责人执行或审核通过后合并

📅 六、发布上线流程

1. 确保 dev 分支功能开发完成

2. 创建 release/vX.X.X 分支，进行最终测试

3. 测试通过后将 release 合并到 master 和 dev：

   git checkout master
   git merge release/vX.X.X
   git push origin master
   
   git checkout dev
   git merge release/vX.X.X
   git push origin dev
   

📎 七、其他建议

• 一次提交尽量只做一件事
• 避免提交格式如 fix something、update 这类模糊信息
• 多人同时开发前，定期沟通分支进度
• 每日同步远程 dev 分支，避免长期分叉