# Git 工作流操作手册 **版本**: v1.0 **创建时间**: 2026-06-18 **适用项目**: 小虾 SaaS --- ## 一、分支结构 ### 主要分支 | 分支 | 用途 | 保护级别 | 合并要求 | |------|------|----------|----------| | **main** | 生产稳定版本 | 🔒 最高 | PR + 2 人 Review + CI 通过 | | **develop** | 开发主线 | 🔒 高 | PR + 1 人 Review + CI 通过 | ### 临时分支 | 分支类型 | 命名 | 从哪里创建 | 合并到 | 示例 | |---------|------|-----------|--------|------| | **feature/** | feature/功能名 | develop | develop | feature/asset-upload | | **bugfix/** | bugfix/bug描述 | develop | develop | bugfix/login-timeout | | **hotfix/** | hotfix/紧急修复 | main | main + develop | hotfix/payment-crash | | **release/** | release/版本号 | develop | main + develop | release/v1.2.0 | --- ## 二、日常开发流程 ### 开发新功能 ```bash # 1. 确保 develop 是最新的 git checkout develop git pull origin develop # 2. 创建功能分支 git checkout -b feature/asset-upload # 3. 开发 + 提交（多次） git add . git commit -m "feat(asset): implement OSS upload" # 4. 推送到远程 git push -u origin feature/asset-upload # 5. 在 Gitea 创建 Pull Request # 访问: https://api.xiaoxiajianji.com/git/xiaoxia/xiaoxia-saas/compare/develop...feature/asset-upload # 6. 等待 CI 检查通过 + Review 通过 # 7. 合并到 develop（在网页上操作） # 8. 删除本地分支 git checkout develop git pull origin develop git branch -d feature/asset-upload ``` ### 修复 Bug ```bash # 1. 从 develop 创建 bugfix 分支 git checkout develop git pull origin develop git checkout -b bugfix/login-timeout # 2. 修复 + 提交 git add . git commit -m "fix(auth): resolve login timeout issue" # 3. 推送并创建 PR（同上） ``` ### 紧急修复（Hotfix） ```bash # 1. 从 main 创建 hotfix 分支 git checkout main git pull origin main git checkout -b hotfix/payment-crash # 2. 快速修复 git add . git commit -m "fix(payment): resolve null pointer crash" # 3. 合并到 main git checkout main git merge --no-ff hotfix/payment-crash git tag -a v1.1.1 -m "Hotfix: payment crash" git push origin main --tags # 4. 合并回 develop git checkout develop git merge --no-ff hotfix/payment-crash git push origin develop # 5. 删除 hotfix 分支 git branch -d hotfix/payment-crash ``` --- ## 三、Commit 规范 ### 格式 ``` ():