目录
[团队 Git 协作完整教程(企业级标准流程)](#团队 Git 协作完整教程(企业级标准流程))
[二、团队使用的标准分支模型(Git Flow)](#二、团队使用的标准分支模型(Git Flow))
[第 1 步:项目管理员创建远程仓库](#第 1 步:项目管理员创建远程仓库)
[第 2 步:团队成员克隆项目(第一次)](#第 2 步:团队成员克隆项目(第一次))
[第 3 步:所有成员切换到开发主分支](#第 3 步:所有成员切换到开发主分支)
[1. 从 develop 创建自己的功能分支](#1. 从 develop 创建自己的功能分支)
[2. 在自己分支上写代码、提交](#2. 在自己分支上写代码、提交)
[3. 每天同步 develop 最新代码(避免冲突)](#3. 每天同步 develop 最新代码(避免冲突))
[4. 功能完成 → 推送到远程](#4. 功能完成 → 推送到远程)
[5. 提交合并请求(MR / PR)](#5. 提交合并请求(MR / PR))
[6. 组长 / 同事审核代码 → 通过 → 合并](#6. 组长 / 同事审核代码 → 通过 → 合并)
[五、修复 BUG 的流程](#五、修复 BUG 的流程)
[七、团队协作最重要的 5 条规则](#七、团队协作最重要的 5 条规则)
[九、团队 Git 提交注释规范(必须统一)](#九、团队 Git 提交注释规范(必须统一))
团队 Git 协作完整教程(企业级标准流程)
你只要照着做,多人开发永远不乱、不冲突、不丢代码 我用最简单、最落地、可直接执行 的方式讲清楚,适用于你们的 Qt 企业项目。
一、团队协作的核心原则(必须遵守)
- 永远不在 master 上直接写代码
- 每个人都有自己的功能分支
- 每天拉取最新代码,避免冲突
- 提交必须写清楚注释
- 合并代码必须经过审核(MR/PR)
- 不提交编译文件、不提交个人配置
二、团队使用的标准分支模型(Git Flow)
你们团队统一用这套,最稳定、最通用:
表格
| 分支名称 | 作用 | 权限 |
|---|---|---|
| master | 线上正式版本(最稳定) | 管理员 |
| develop | 开发主分支(每日集成) | 所有人 |
| feature/xxx | 功能开发分支(每个人一条) | 开发者 |
| fix/xxx | BUG 修复分支 | 开发者 |
| release/xxx | 发布版本分支 | 管理员 |
三、团队协作完整流程(一步一步跟着做)
第 1 步:项目管理员创建远程仓库
- 在 Gitee / GitHub / GitLab 创建仓库
- 上传初始化代码
- 邀请团队成员加入
第 2 步:团队成员克隆项目(第一次)
bash
运行
git clone 仓库地址
cd QtEnterprise
第 3 步:所有成员切换到开发主分支
bash
运行
git checkout develop
git pull origin develop
四、开发新功能的标准流程(每个人都这样做)
1. 从 develop 创建自己的功能分支
bash
运行
git checkout develop
git pull
git checkout -b feature/你的名字-功能名
例子:
bash
运行
git checkout -b feature/zhangsan-ui
git checkout -b feature/lisi-database
2. 在自己分支上写代码、提交
bash
运行
git add .
git commit -m "feat: 完成登录界面"
3. 每天同步 develop 最新代码(避免冲突)
bash
运行
git checkout develop
git pull
git checkout feature/xxx
git merge develop
4. 功能完成 → 推送到远程
bash
运行
git push origin feature/xxx
5. 提交合并请求(MR / PR)
在 Gitee/GitHub 网页点:Create Pull Request → 合并到 develop
6. 组长 / 同事审核代码 → 通过 → 合并
五、修复 BUG 的流程
bash
运行
git checkout develop
git pull
git checkout -b fix/登录失败
改完后:
bash
运行
git add .
git commit -m "fix: 修复密码错误问题"
git push origin fix/登录失败
提交 MR → 合并到 develop
六、版本发布上线流程
bash
运行
git checkout develop
git pull
git checkout -b release/v1.0.0
测试 → 修复小问题 → 合并到 master 和 develop
bash
运行
git checkout master
git merge release/v1.0.0
git push
git checkout develop
git merge release/v1.0.0
git push
七、团队协作最重要的 5 条规则
- 一个功能一个分支
- 分支命名必须规范
- 每天至少拉取一次 develop
- 不提交无用文件(.gitignore)
- 提交注释必须清晰
八、冲突怎么办?(团队最害怕的问题)
冲突原因:
两个人修改了同一个文件的同一行
解决方法(超级简单)
- 拉代码时提示冲突
- 打开冲突文件
- 看到:
plaintext
<<<<<<< HEAD
你的代码
=======
别人的代码
>>>>>>>
- 保留正确的,删除错误的,删掉符号
- 保存
- 提交
bash
运行
git add .
git commit -m "merge: 解决冲突"
九、团队 Git 提交注释规范(必须统一)
plaintext
feat: 新增功能
fix: 修复BUG
docs: 修改文档
style: 格式化代码
refactor: 重构代码
chore: 构建/配置/脚本
例子:
plaintext
git commit -m "feat: 添加数据库连接池"
git commit -m "fix: 修复UI界面崩溃问题"
十、团队每天的工作流(复制照着做)
bash
运行
1. 早上拉代码
git checkout develop
git pull
2. 切换到自己的分支
git checkout feature/xxx
3. 同步最新代码
git merge develop
4. 写代码
5. 提交
git add .
git commit -m "feat: xxx"
git push