GitHub 零基础学习实战:Github-for-beginners 完整指南,7 步走完 Fork 到 Pull Request 全流程

原创2026-11-16 11:47:3923 阅读

GitHub 零基础学习实战:Github-for-beginners 完整指南,7 步走完 Fork 到 Pull Request 全流程

对于想入门版本控制的零基础用户来说,Github-for-beginners 就是一个专门的 GitHub 实战练习仓库:它带你完整走一遍 Fork、Clone、分支、Commit、Push 到 Pull Request 的全流程。这篇文章把整个上手路径拆成 7 个步骤,配合项目自带截图与文档,照着做就能完成你的第一个 GitHub 协作贡献。

开始前:环境准备 1 分钟

先安装好 Git(终端执行 git --version 验证版本即可)和 Visual Studio Code。详细安装说明见:

  • Prerequisites – GitHub 101 (For Beginners).pdf.pdf):Git / VS Code 安装指南
  • win-cmd.md:Windows 用户在资源管理器中打开命令行的方法

GitHub 零基础学习实战中的 Git 工作流四阶段示意图

理解这张图,你就理解了 Git 的骨架:文件改动(Working Directory)→ git add 加入暂存区(Staging Area)→ git commit 保存为本地提交(Local Commits)→ git push 推送到远程仓库(GitHub)。后文 7 步全部围绕这条链路展开。

第 1 步:Fork 仓库,拥有自己的副本

Fork(叉取)就是把别人的仓库复制一份到自己的账号下,这样怎么改都不会影响原项目——它是 GitHub 协作的基础。

  1. 打开仓库页面,点击右上角 Fork 按钮:

GitHub Fork 仓库第一步:点击页面右上角的 Fork 按钮

  1. 在 "Create a new fork" 页面保持默认设置(Owner 选自己、勾选 Copy the main branch only),点击 Create fork:

GitHub Fork 仓库确认页:选择 Owner 并点击 Create fork 按钮

  1. 完成后回到你的 Fork,页面会显示 "forked from ...",说明副本创建成功。

💡 每一步的详细说明见:fork.md

第 2 步:Clone 到本地,并给 Git 配置身份

建议先在桌面新建一个 workshop 文件夹,在里面打开终端,执行:

git clone https://gitcode.com/gh_mirrors/gi/Github-for-beginners
cd Github-for-beginners

接着配置 Git 身份(提交时必须用到):

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

配置好后,可以在终端执行 code . 直接用 VS Code 打开项目,体验更顺滑。

第 3 步:创建一个属于你自己的分支

永远不要直接在 main 上改代码,这是协作的第一条规矩。用你的用户名创建一个新分支并切换过去:

git checkout -b feature/your-name-introduction

第 4 步:修改文件、Commit 提交

打开 student-introductions.md,按文件里的模板填写你的介绍(GitHub 用户名、所在地、学习目标等),保存。然后执行"检查 → 暂存 → 提交"三连:

git status
git add student-introductions.md
git commit -m "Add introduction for 你的名字"

⚠️ 如果提交时报 "no email was given" 之类的错误,说明 Git 没有识别到你的身份,按 Git-Configuration-Troubleshooting.md 排查即可。

第 5 步:Push 推送分支到远程

git push origin feature/your-name-introduction

执行完,你的分支就出现在自己 Fork 的仓库里了。

第 6 步:创建 Pull Request(PR)

  1. 打开你的 Fork,会看到 "Compare & pull request" 提示,点击即可;也可以进入 Pull requests 标签页手动创建。
  2. 确认 compare 分支指向你的新分支,填写标题和描述,点击 Create pull request:

创建 Pull Request:确认 compare 分支后点击 Create pull request

  1. 创建成功后,复制页面顶部的 PR 链接备用(下一步要填进 issue):

创建 Pull Request 成功后在浏览器地址栏复制 PR 链接

更完整的跨仓库 PR 操作参考:fork.md 与项目 README 中的 Exercise 5。

第 7 步:用 Issue 提交作业,完成闭环

按项目的 CONTRIBUTING.md 要求,回到原仓库创建作业 issue:

  1. 进入 Issues 标签页,点击 New issue,选择 Submission 模板:

创建 Issue 提交作业:点击 New issue 并选择 Submission 模板

  1. 填写姓名、学校、Pull Request 链接等信息,点击 Create 完成提交:

填写 Submission 表单信息后点击 Create 创建 Issue

遇到报错别慌:2 个常见问题

问题 1:commit 报错 "no email was given and auto-detection is disabled"

说明 Git 不知道你是谁,先执行第 2 步的两条 git config --global 配置命令即可解决:

Git commit 报错 no email was given 的常见错误提示界面

问题 2:分支合并冲突

练习中若遇到冲突,不要慌,仓库里就有专门的新手指南:

更多主题(GitHub Pages 部署、个人 Profile README 美化)见 guides/README.md。

完成度检查清单

全部完成后,逐项对照打勾(也见 README.md 的 Checklist 章节):

  • [x] 成功 Fork 了仓库
  • [x] 克隆到本地机器
  • [x] 创建了至少 2 个不同分支
  • [x] 写出了描述清晰的 commit
  • [x] 把分支推送到 GitHub
  • [x] 创建了至少 1 个 Pull Request
  • [x] 在原仓库创建了 1 个 Submission issue
  • [x] 在 student-introductions.md 中留下自我介绍

🎓 进阶练习:仓库还内置了 practice-file.md 和一份可随时查阅的 git-commands-reference.md 命令速查表,建议收藏。

写在最后

Fork → Clone → 分支 → Commit → Push → Pull Request,这条链路走完一遍,你就已经掌握了开源协作 80% 的日常操作。犯错是学习的一部分,大胆试、放心练——下一个提交,就是你的第一个真实贡献。🎉

登录后查看全文
Github-for-beginners