# git-flow

**Repository Path**: power9508/git-flow

## Basic Information

- **Project Name**: git-flow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git 标准化开发流程

1. 分支命名规范

- `master`：生产主分支（永久保护，不可直接提交）
- `test`：测试分支（永久分支，用于提测验证）
- `feature/xxx`：功能开发分支（临时分支）
- `fix/xxx`：线上 Bug 修复分支（临时分支）

2. 提交信息规范

- `feat: 功能描述`：新功能
- `fix: 问题描述`：Bug 修复
- `refactor: 描述`：代码重构（无功能变更）
- `docs: 描述`：文档修改

## Step 1：初始化测试分支（项目初期仅执行一次）

作用：创建团队共用的测试分支，关联远程仓库

1. 切换到生产主分支（确保基线正确）
   git checkout master
2. 拉取远程master最新代码（保证本地与远程一致）
   git pull origin master
3. 本地创建test测试分支，并自动切换到该分支
   git checkout -b test
4. 将本地test分支推送到远程，并建立关联（-u = --set-upstream）
   关联后，后续直接用 git pull/git push 即可，无需加分支名
   git push -u origin test

## Step 2：创建功能分支（每次开发新功能前必执行）

核心原则：永远基于最新 master 创建功能分支，保证开发基线干净

1. 切换到生产主分支
   git checkout master
2. 拉取远程最新代码（必须执行，防止基于旧代码开发）
   git pull origin master
3. 本地创建功能分支（命名：feature/功能名），并自动切换
   示例：feature/xxx
   git checkout -b feature/xxx

## Step 3：日常开发与提交（开发过程中反复执行）

原则：小步提交、频繁推送，防止代码丢失，方便协作

1. 将所有修改的文件加入暂存区（. 代表当前目录所有变更）
   git add .
2. 提交到本地仓库，必须遵循提交规范
   git commit -m "feat: xxx"
3. 将本地功能分支推送到远程（备份+协作可见）
   git push origin feature/xxx

## Step 4：合并至测试分支（功能开发完成，提测）

1. 切换到测试分支
   git checkout test
2. 拉取远程test最新代码（防止多人协作冲突）
   git pull origin test
3. 将功能分支代码合并到test分支，自定义合并提交信息
   git merge feature/xxx -m "Merge feature/xxx into test"
4. 将合并后的test分支推送到远程（完成提测）
   git push origin test

## Step 5：测试 Bug 修复循环（测试不通过时执行）

严禁直接在 test 分支修改代码，所有修复必须回到原功能分支

第一步：回到功能分支修复Bug

1. 切回原功能开发分支
   git checkout feature/xxx
2. 添加修复后的代码到暂存区
   git add .
3. 提交修复（用fix前缀标识）
   git commit -m "fix: xxx"
4. 推送修复代码到远程功能分支
   git push origin feature/xxx

第二步：重新合并到测试分支

1. 切回测试分支
   git checkout test
2. 拉取最新test代码
   git pull origin test
3. 合并修复后的功能分支到test
   git merge feature/xxx -m "Merge bugfix into test"
4. 推送更新后的测试分支
   git push origin test

重新部署测试环境，验证修复

## Step 6：合并至生产分支（测试通过，正式上线）

1. 切换到生产主分支
   git checkout master
2. 拉取远程master最新代码（关键！避免上线冲突）
   git pull origin master
3. 将功能分支合并到主分支，使用Release标识上线
   git merge feature/xxx -m "Release: xxx 上线"
4. 推送合并后的代码到远程master
   git push origin master

上线操作：执行部署脚本，发布master到生产服务器

## Step 7：清理本地 + 远程分支（上线完成后）

作用：保持仓库整洁，避免无效分支堆积

1. 安全删除本地功能分支
   -d：安全删除（Git会校验分支是否已合并，未合并会报错拦截）
   -D：强制删除（慎用！会删除未合并的代码）
   git branch -d feature/xxx
2. 删除远程仓库的功能分支
   git push origin --delete feature/xxx

## 补充：高频异常处理（团队必备）

1.  误删分支恢复
    git reflog 查看提交记录 → git checkout -b 分支名 提交ID
2.  撤销本地未推送提交
    git reset --soft HEAD^（保留代码，撤销上一次提交）