多人协作Git开发流程指南

1. 初始克隆项目

bash 复制代码

#克隆远程仓库
git clone <repository-url>
cd <project-directory>

#查看所有分支
git branch -a

#确认当前所在分支（通常是 main 或 master）
git branch

2. 创建自己的功能分支

bash 复制代码

# 基于主分支创建新分支
git checkout -b feature/your-name/feature-description

⭐️分支命名规范

feature/your-name/short-description（推荐）
示例：feature/zhang-san/user-authenticat

3. 在分支上进行开发

bash 复制代码

# 在个人分支上工作
git status
git add <files>
git commit -m "描述清晰的提交信息"

# 定期推送分支到远程
git push -u origin feature/your-branch-name

4. 保持分支更新

bash 复制代码

# 定期同步主分支的更新
git fetch origin

# 将主分支的更新合并到你的分支
git merge origin/main

# 或者使用 rebase（更整洁的历史）
git rebase origin/main

5.发起 Pull Request / Merge Request

推送最终代码：git push origin feature/your-branch-name
在 GitLab/GitHub 上创建 Merge Request
等待代码审查
根据反馈进行修改

6. 代码合并后的清理

bash 复制代码

# 切换回主分支
git checkout main

# 拉取最新代码（包含你的合并）
git pull origin main

# 删除本地分支（可选）
git branch -d feature/your-branch-name

# 删除远程分支（可选）
git push origin --delete feature/your-branch-name

紧急修复流程

bash 复制代码

git checkout main
git pull origin main
git checkout -b hotfix/your-name/issue-description
# 进行修复并提交
git push origin hotfix/your-name/issue-description

📚重要最佳实践

✅ 一定要做

✅ 始终在个人分支上开发
✅ 提交前测试代码
✅ 编写清晰的提交信息
✅ 保持分支与主分支同步
✅ 定期推送分支到远程

❌ 避免做：

❌ 直接在 main/master 分支上开发
❌ 提交不完整或无法运行的代码
❌ 使用模糊的提交信息
❌ 长时间不同步主分支更新

🆘 常见问题处理

解决合并冲突

bash 复制代码

# 当合并时出现冲突
git status                    # 查看冲突文件
# 手动解决冲突后
git add <resolved-files>
git commit                   # 完成合并提交

注：每个新功能或修复都应该在独立的分支上完成，这是多人协作的核心原则！这样可以保持主分支的稳定性，便于代码审查和问题追踪。