GitHub 零基础学习实战:Github-for-beginners 完整指南,7 步走完 Fork 到 Pull Request 全流程
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 用户在资源管理器中打开命令行的方法
理解这张图,你就理解了 Git 的骨架:文件改动(Working Directory)→ git add 加入暂存区(Staging Area)→ git commit 保存为本地提交(Local Commits)→ git push 推送到远程仓库(GitHub)。后文 7 步全部围绕这条链路展开。
第 1 步:Fork 仓库,拥有自己的副本
Fork(叉取)就是把别人的仓库复制一份到自己的账号下,这样怎么改都不会影响原项目——它是 GitHub 协作的基础。
- 打开仓库页面,点击右上角 Fork 按钮:
- 在 "Create a new fork" 页面保持默认设置(Owner 选自己、勾选 Copy the main branch only),点击 Create fork:
- 完成后回到你的 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)
- 打开你的 Fork,会看到 "Compare & pull request" 提示,点击即可;也可以进入 Pull requests 标签页手动创建。
- 确认 compare 分支指向你的新分支,填写标题和描述,点击 Create pull request:
- 创建成功后,复制页面顶部的 PR 链接备用(下一步要填进 issue):
更完整的跨仓库 PR 操作参考:fork.md 与项目 README 中的 Exercise 5。
第 7 步:用 Issue 提交作业,完成闭环
按项目的 CONTRIBUTING.md 要求,回到原仓库创建作业 issue:
- 进入 Issues 标签页,点击 New issue,选择 Submission 模板:
- 填写姓名、学校、Pull Request 链接等信息,点击 Create 完成提交:
遇到报错别慌:2 个常见问题
问题 1:commit 报错 "no email was given and auto-detection is disabled"
说明 Git 不知道你是谁,先执行第 2 步的两条 git config --global 配置命令即可解决:
问题 2:分支合并冲突
练习中若遇到冲突,不要慌,仓库里就有专门的新手指南:
- merge-conflicts.md:逐步解决冲突
- undoing-changes.md:
git restore/git reset用错时如何撤销 - gitignore.md:学会排除不该提交的文件
更多主题(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% 的日常操作。犯错是学习的一部分,大胆试、放心练——下一个提交,就是你的第一个真实贡献。🎉







