前言
在现代软件开发中,多人协作已成为绝大多数项目的常态。对于刚入门的小型团队而言,如何高效使用 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',填写说明并提交。


