多人协作Git开发流程指南

1. 初始克隆项目

#克隆远程仓库
git clone <repository-url>
cd <project-directory>#查看所有分支
git branch -a#确认当前所在分支（通常是 main 或 master）
git branch

2. 创建自己的功能分支

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

⭐️分支命名规范

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

3. 在分支上进行开发

# 在个人分支上工作
git status
git add <files>
git commit -m "描述清晰的提交信息"# 定期推送分支到远程
git push -u origin feature/your-branch-name

4. 保持分支更新

# 定期同步主分支的更新
git fetch origin# 将主分支的更新合并到你的分支
git merge origin/main# 或者使用 rebase（更整洁的历史）
git rebase origin/main

5.发起 Pull Request / Merge Request

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

6. 代码合并后的清理

# 切换回主分支
git checkout main# 拉取最新代码（包含你的合并）
git pull origin main# 删除本地分支（可选）
git branch -d feature/your-branch-name# 删除远程分支（可选）
git push origin --delete feature/your-branch-name

紧急修复流程

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 分支上开发
• ❌ 提交不完整或无法运行的代码
• ❌ 使用模糊的提交信息
• ❌ 长时间不同步主分支更新

🆘 常见问题处理

解决合并冲突

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

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