一份写给 GitHub 新手的零基础教程：从看懂仓库首页，到创建仓库、写 README、理解 commit、branch、Pull Request，再到上传本地项目和参与开源。
很多 GitHub 教程默认读者已经懂 Git、命令行和开源协作。但真正的新手经常卡在更早的地方：
- 不知道 GitHub 首页上的 Code、Issues、Pull requests 是什么
- 不知道 Git 和 GitHub 有什么区别
- 不知道 repository、commit、branch、fork、clone 这些词怎么理解
- 不知道 README.md 应该写什么
- 不知道为什么本地 commit 了，GitHub 上还看不到
- 想参与开源项目，但不敢提交第一个 Pull Request
GitHub 新手村的目标不是做命令大全，而是帮你建立 GitHub 的基本地图。
如果你完全没有经验，不要先读完整目录。先打开：
它只要求你完成 4 个小目标：
- 认识 GitHub 仓库页面
- 创建第一个仓库
- 写第一份 README
- 理解第一次 commit
只学 30 分钟，也能从“完全没用过”变成“知道下一步该做什么”。
- 路线完整：从注册、创建仓库、README、commit、branch、PR 到本地上传。
- 解释友好：每个概念都尽量使用生活化比喻，而不是直接堆术语。
- 能直接练习：每章配练习任务，
exercises/提供可照做的小项目。 - 遇错能排查：整理了新手最常见的 Git/GitHub 报错。
- 适合反复查：提供术语表、速查表、模板、FAQ 和 30 天计划。
- 可以参与贡献：文档类任务适合完成第一次开源 PR。
- 第一次打开 GitHub 的新手
- 编程初学者、学生、转码学习者
- 想上传作业、作品集、学习笔记的人
- 想参与开源但不理解 fork、issue、PR 的人
- 想写出更专业 README 的项目作者
- 想给团队新人一份 GitHub 入门材料的老师、社群组织者和技术负责人
| 能力 | 学完后的状态 |
|---|---|
| 看懂仓库 | 知道 README、Issues、Pull requests、Stars、License 在哪里 |
| 创建项目 | 能创建公开仓库，并写出基础 README |
| 理解记录 | 能解释 commit 是什么，知道如何写提交说明 |
| 使用分支 | 能理解 branch 是独立修改路线 |
| 发起协作 | 能创建一个简单 Pull Request |
| 上传本地项目 | 能把电脑里的项目推送到 GitHub |
| 排查问题 | 遇到常见报错时知道先看哪里 |
| 参与开源 | 能从文档贡献开始完成第一次 PR |
0. 先上手
START_HERE -> 第一个仓库 -> 第一次 README -> 第一次 commit
1. 认识 GitHub
GitHub 是什么 -> Git 和 GitHub 的区别 -> 仓库页面怎么看
2. 发布第一个项目
README.md -> Markdown -> 上传文件 -> commit
3. 理解协作
branch -> pull request -> issue -> fork -> clone
4. 连接本地工具
GitHub Desktop -> VS Code -> 常用 Git 命令 -> 本地项目上传
5. 参与开源
good first issue -> fork -> branch -> PR -> review -> merge
| 你现在的情况 | 建议打开 |
|---|---|
| 完全不知道 GitHub 是什么 | 从这里开始 |
| 想按天学习 | 30 天学习计划 |
| 看不懂英文术语 | GitHub 新手术语表 |
| 命令行报错了 | 常见报错排查 |
| 想马上做练习 | 新手练习项目 |
| 想快速查命令 | Git 常用命令速查表 |
| 想写 README | README 模板 |
| 想第一次贡献开源 | Good First Issue 设计 |
- GitHub 是什么
- Git 和 GitHub 有什么区别
- 如何创建你的第一个 GitHub 仓库
- README.md 是什么？为什么它很重要
- Commit 是什么？如何理解它
- Branch 是什么？为什么要用分支
- Pull Request 是什么？新手如何理解
- 如何把本地项目上传到 GitHub
完整规划见 docs/tutorial-plan.md。
| 概念 | 新手理解 |
|---|---|
| Repository | 一个项目文件夹，简称 repo 或仓库 |
| README | 项目的首页说明书 |
| Commit | 一次保存记录，说明你改了什么 |
| Branch | 一条独立的修改路线 |
| Pull Request | 请求别人检查并合并你的修改 |
| Issue | 问题、建议、任务的讨论区 |
| Fork | 复制一份别人的仓库到自己账号下 |
| Clone | 把 GitHub 上的仓库下载到本地电脑 |
| License | 告诉别人可以如何使用你的项目 |
- 每次只学一个概念，不要一开始背所有命令。
- 先用 GitHub 网页版，再用 GitHub Desktop，最后学命令行。
- 每读一章都做一个小练习。
- 把自己的学习笔记放到 GitHub，这本身就是练习。
- 遇到报错时先读错误信息，再看 常见报错排查。
为了让这个项目长期可收藏、可转发、可贡献，后续内容会遵守这些标准：
- 新手优先：不默认读者懂命令行、Git 或开源流程。
- 一章一目标：每章解决一个明确问题。
- 解释加操作：每个核心概念都要有解释、步骤、练习和常见错误。
- 小步可完成：练习任务尽量在 10 到 30 分钟内完成。
- 文档可维护：新增内容要能被目录、路线图和 FAQ 找到。
完整标准见 docs/project-standard.md。
这个项目欢迎新手参与。你可以从这些小任务开始：
- 修正文档错别字
- 补充一个生活化例子
- 添加一个常见错误
- 补充截图
- 改进 FAQ
- 翻译一个小节
请先阅读 CONTRIBUTING.md 和 Good First Issue 设计。
如果你在学习时卡住了，先看 SUPPORT.md。提问时写清楚你想做什么、卡在哪一步、看到什么报错，会更容易得到有效帮助。
如果这个项目帮你看懂了 GitHub，可以点一个 Star，方便以后回来查术语、命令、模板和练习，也能让更多刚入门的人看到它。
本项目使用 MIT License。你可以自由学习、分享、修改和再发布，但需要保留原始 License 说明。