文章目录保姆级 GitHub 协作教程从 clone 到提 PR 的完整流程一、先分清 Git 和 GitHub二、核心概念先搞懂这 5 个三、环境准备1. 装 git 并配置身份2. 认证私有仓库必须四、完整流程一步步来第 1 步clone 仓库第 2 步建分支第 3 步改文件、提交第 4 步推送分支第 5 步开 PR第 6 步等代码评审五、用 GitHub Desktop 操作图形界面新手友好六、命令速查表总结保姆级 GitHub 协作教程从 clone 到提 PR 的完整流程本文以一个真实任务给团队仓库提交一个新文件为例讲清楚 GitHub 协作开发的全流程clone → 建分支 → 提交 → 推送 → 开 PR → 代码评审。适合第一次参与团队项目的新人。一、先分清 Git 和 GitHubGit一个版本管理工具在你电脑本地运行管的是代码的历史记录。GitHub一个托管代码的网站把 Git 仓库放在云端方便多人协作。一句话Git 是工具GitHub 是网站。二、核心概念先搞懂这 5 个仓库Repository一个项目的代码 历史记录。分支Branch一条独立的开发线。main是主干正式代码你做新功能要新建一个分支在上面改改完再合回主干。提交Commit一次存档记录你改了哪些文件。远程RemoteGitHub 上的仓库对应你本地的仓库。Pull RequestPR申请把我的分支合并进主干让别人先审查。为什么要用分支因为你不能直接在主干上改——改错了会影响所有人。分支就是你的草稿改好、别人审查通过才合并进主干。三、环境准备1. 装 git 并配置身份git--version# 看装没装没装就 sudo apt install -y gitgitconfig--globaluser.name你的GitHub用户名gitconfig--globaluser.email你的GitHub邮箱2. 认证私有仓库必须私有仓库 clone 需要认证。两种方式GitHub Desktop推荐新手登录 GitHub 账号即可不用手动配 token。命令行生成 Personal Access TokenSettings → Developer settings → Personal access tokens → Tokens (classic) → 勾repo然后gitclone https://用户名:tokengithub.com/组织名/仓库名.git⚠️token 是账号的钥匙永远别贴到聊天、别贴进代码。更安全的做法是 clone 时不带 token让 git 用密码提示问你输入时不会显示。四、完整流程一步步来第 1 步clone 仓库gitclone https://github.com/组织名/仓库名.gitcd仓库名如果仓库有子模块加--recursivegit clone --recursive ...第 2 步建分支gitcheckout-bfeat/你的功能名分支命名习惯feat/xxx新功能、fix/xxx修 bug、docs/xxx文档。第 3 步改文件、提交gitstatus# 看改了哪些文件gitadd文件名# 把改动加入暂存区gitcommit-mfeat(scope): 描述# 提交message 要清晰团队通常有提交信息规范比如 Conventional Commits照着写别乱发挥。第 4 步推送分支gitpush-uorigin feat/你的功能名第 5 步开 PR推完后git push输出里会有一个开 PR 的链接点开或去 GitHub 仓库页面点 “Compare pull request”确认方向base 主干分支如main或developcompare 你的分支填标题会变成最终合并的 commit message要完整、别太长填描述按团队的 PR 模板写点Create pull request第 6 步等代码评审导师/同事会 review 你的 PR可能直接 approve merge→ 完成 ✅提意见让你改→ 你改文件 → 重新 commit → push 到同一个分支→ PR 自动更新 → 再等 review五、用 GitHub Desktop 操作图形界面新手友好如果不想敲命令GitHub Desktop 全程点鼠标File → Clone repository→ 搜仓库名 → clone顶部Current branch → New branch→ 建分支把改好的文件复制进仓库文件夹左侧Changes里填提交信息 → 点Commit点Publish branch推送点Create Pull Request开 PR如果提示 “You don’t have write access… Want to create a fork?”说明你对仓库只有读权限走fork复刻 PR流程把仓库复制到你自己的账号下推到你的 fork再从 fork 向原仓库开 PR。六、命令速查表命令作用git clone 地址克隆仓库git checkout -b 分支名新建并切换分支git status看当前状态git add .加入全部改动git commit -m 信息提交git push origin 分支名推送git pull拉取远程更新git log --oneline看提交历史总结团队协作的核心流程就一句话建分支 → 改 → 提交 → 推送 → 开 PR → 评审 → 合并。记住两件事别直接在主干上改、提交信息要规范你就能顺利参与团队开发了。
