事情是这样的。前几天刷到一篇 GitHub 的万字长文，作者叫想风，从注册一直讲到提 PR，二十四万人看过，一千五百多人点赞。我本来寻思这种老掉牙的选题还能写出什么花，结果一路读下来，好几个点我自己都是第一次知道。

比如 Blame。你在网页上看代码，看到一行看不懂的，点一下它，能看到这一行是谁、什么时候、因为哪次提交写上去的。提交说明里往往就写着「临时方案，等 XX 上线后删掉」。一下就把「这段代码为什么这么怪」变成了「这段代码是欠债」。用了多年 GitHub 的人，上周才发现这个功能。

▲ 想风万字长文的封面，从入门到精通

所以我把它拆给你。那万字不用看，骨架就这么多。

先拆解，Git 和 GitHub 是两个东西

很多新手卡死在第一步，把这俩当成一个词。

Git 是装在你自己电脑上的版本管理工具，断网也能用，2005 年 Linux 之父 Linus Torvalds 写的。GitHub 是个网站，帮你把 Git 仓库放到云上保管和共享，2018 年被微软花 75 亿美元买下。

打个比方。Git 是你抽屉里的记账本，GitHub 是银行。记账本在你手里，银行帮你保管和共享。没有银行，记账本照样记，没有记账本，银行就是个空壳。

▲ 文章第一节配图，先分清 Git 和 GitHub

再拆解，你不写代码，为什么也要有个账号

三个理由，一个比一个实际。

第一，带历史的备份。作者本人吃过亏，本地一个项目文件夹用命令行删了，回收站里都没有，三天的工作直接没了。Git 就是防这个的。

第二，简历。招人的会点进你主页看提交记录，一个空白的账号，比没有账号还尴尬。

第三，也是我觉得最值钱的。全世界最好的代码都摊开放在那里，免费看。你想学的任何东西，从小工具到大框架，源码就在那躺着。

流程，从零到推上去第一行代码

第一步，注册。官网右上角 Sign up。三个坑提前说。用户名会永久绑进你所有仓库的网址，别用一串数字。邮箱别用国内邮箱，验证邮件容易收不到，作者重发了四次，换 Gmail 才过。两步验证记得开，恢复码只显示一次，存密码管理器里，别截图放相册，作者换手机被锁了两天才找回账号。

▲ 注册与配置章节配图，用户名、邮箱、两步验证三个坑

第二步，装 Git，配身份。装完把用户名和邮箱跟 GitHub 账号对齐。邮箱一定要一致，对不上，你的提交头像就是个灰方块，贡献格子也不亮。

第三步，日常就三行命令。git add 把改动放进暂存区，git commit 给当前状态拍张快照附一句说明，git push 推到云上。记住这三行，你就已经能干活了。其余的，用到再查。

第四步，配 SSH key，一劳永逸。第一次 push 会让你输密码，但 GitHub 早就不收账号密码了，它只说认证失败，不告诉你为什么，作者在这卡了一整晚。去设置里生成一把密钥，把公钥贴上去，验证通过，以后 push 再也不问。

▲ SSH 密钥配置章节配图，配好后永久免密

中间插一个我自己很喜欢的细节。很多人不敢建分支，以为每建一个就把代码复制一份，硬盘要炸。其实分支不是拷贝，是一个指针，建一个瞬间完成，不占空间。分支真正的价值是「可以推倒重来」，在分支上改崩了，删掉重建，两秒钟的事。在 main 上直接改，改崩了可没有退路。

看懂一个陌生项目，别从第一行读起

不是从第一行开始读，那是新手最容易死的姿势，一个项目几万行，读到天亮也读不出东西。

正确的是五步。只读 README，五分钟搞清它解决什么问题，README 写得烂的项目直接放弃，文档烂代码通常也烂。跑起来，静态读代码的效率比跑起来低十倍。找入口。然后只挑一个最小的功能，比如点登录按钮，从入口一路跟到数据库，链路走通一次，整个项目的骨架你就摸到了。

最后看 Blame 和提交历史。顺手记两个网页快捷键，按 t 直接跳文件，按 . 把整个仓库变成网页版 VS Code。这两个键，用一次就回不去。

▲ 读懂源码章节配图，先找入口，再走通一条线

提第一个 PR，从改错别字开始

想给别人的项目做贡献，门槛比你想的低。点 Fork 把仓库复制一份到你账号下，建个分支改完，推上去，回网页点 Compare & pull request，正文写清改了什么、为什么改。修的是哪个问题单，就写一句 Closes 加编号，合并后它自动关闭。

维护者不理你也正常，开源是义务劳动，一个 PR 挂几周很正常，别催。不知道从哪下手，就搜 good first issue，这是维护者专门留给新人的标签。

▲ 提 PR 章节配图，从 fork 到被合并的完整流程

顺便给你一个搜索心法。大部分人用 GitHub 只在搜索框打一个词，然后在一堆结果里翻，翻到的多半是三年没人管的死项目。加一个 pushed: 限定符，比如搜完再补一句 pushed 大于今年的日期，直接把还活着的项目过滤出来，这一招帮我绕开了大半坟墓。想学什么，还可以先搜 awesome 加关键词，那是别人替你整理好的宝藏清单。

白嫖清单，一张表看明白

提醒一句，Actions 的 macOS 机器是 10 倍计费，跑 10 分钟算 100 分钟。作者给 iOS 项目配了一次，23 次构建直接把当月额度烧爆，收到邮件才知道。

还有几个代价最高的坑。.env 别提交，里面是密钥和密码，交上去等于公开发布，删掉文件也没用，历史里还在，最省事的做法是直接作废重申请。单文件上限 100MB，超了推不上去，报错还不告诉你是哪个文件。

写在最后

原文万字，我抽的就是这副骨架。想看完整版的，去 X 上搜想风就能找到，写得是真细。

GitHub 不是一个需要「学完」的东西，是一个你用得越多、发现越多的地方。要是这篇让你第一次认真注册了个账号，点个赞就行。

本文整理自 @xaiwind（想风）2026 年 9 月 27 日发布的 GitHub 万字长文教程，文中经验、案例与数据均引自原文，配图版权归原作者所有。GitHub 功能与免费额度以官方页面为准，不构成任何使用建议。
觉得有用的话，点个「赞」和「在看」，我们，下期见。