前言
在现代软件开发中，多人协作已成为绝大多数项目的常态。对于刚入门的小型团队而言，如何高效使用 GitHub 进行协作开发，是提升开发效率和保证代码质量的关键。本教程面向初学者，从仓库创建、成员管理、分支使用，到 Pull Request 审核、冲突解决和任务分配，逐步介绍 GitHub 的核心协作流程，并结合最佳实践，帮助团队快速建立规范的工作方式。
一、创建远程仓库
在 GitHub 主页点击右上角 '+' → 'New repository'。
填写仓库名称（如 my-project），选择 Public/Private，可勾选 'Add a README'。
点击 'Create repository' 完成创建。
二、添加团队成员或协作者
- 组织仓库： 在组织主页 → People → Add member，选择成员角色（Owner/Member）。 也可将成员加入 Team 来统一管理权限。
个人仓库： 进入仓库 → Settings → Collaborators → Add collaborator。 输入成员 GitHub 用户名或邮箱，点击添加，对方接受邀请后即可协作。
三、配置本地 Git 与 GitHub
- 设置用户名和邮箱：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
- 生成 SSH Key：
ssh-keygen -t ed25519 -C "你的邮箱"
将生成的公钥 (id_ed25519.pub 中的内容) 添加到 GitHub → Settings → SSH and GPG keys。
- 克隆仓库：
git clone [email protected]:用户名/仓库名.git
四、推荐的分支策略
- main：稳定分支，可随时发布到生产。
- develop：集成分支，用于日常开发。
- feature/xxx：功能分支，每个新功能或修复在独立分支中完成。
五、新功能的开发&提交流程
- 创建分支（新功能）：
git checkout develop
git checkout -b feature/login-feature
- 开发并提交：
git add .
git commit -m "Add login feature"
- 推送分支：
git push -u origin feature/login-feature
- 发起 Pull Request（PR）：
项目组成员发起将自己开发的分支合并到主分支的请求： 在 GitHub 上点击 'Compare & pull request'，填写说明并提交。
六、Pull Request 的评审与合并
仓库管理员决定是否要接受远程的合并请求：
- 审查代码，提出修改建议。
- 审核通过后，点击 'Merge pull request'。
- 可选择 Merge commit、Squash and merge、Rebase and merge。
- 合并完成后可删除分支以保持整洁。
七、解决冲突的流程
- 网页解决：在 PR 页面点击 Resolve conflicts，手动编辑冲突部分，保存并标记为已解决。
- 本地解决：
git fetch origin
git checkout feature/login-feature
git merge develop # 手动修改冲突文件
git add .
git commit
git push
八、使用 Issues 和 Projects 做任务分配与跟踪
- Issues：记录 bug、功能、任务，可分配给成员并添加标签。
- Projects：使用看板（To do / In progress / Done）管理任务进度，可拖拽 Issue/PR 进行管理。
九、最佳实践
- Commit message 规范： 使用动词开头，如 Add login page、Fix bug in header 不要写模糊描述如 'update' 引用相关 Issue：Fixes #12
- 保持分支同步：定期 git pull 避免冲突。
- 谨慎使用强制推送：如需清理历史，用 git push --force-with-lease。
总结
通过以上步骤，小型团队可以在 GitHub 上顺利开展多人协作开发：利用分支策略避免代码混乱，借助 Pull Request 审核提升质量，使用 Issues 和 Projects 管理任务进度，并遵循提交规范与良好习惯保持团队协作高效顺畅。随着熟练度的提高，团队还可以引入更完善的 CI/CD 流程和分支保护策略，使项目协作更加安全、稳定和可扩展。
