完整指南:AI 编程新手的 GitHub 入门课

很多人开始 AI 编程以后，会犯一个很自然的错：

以为只要会跟 Cursor、Claude Code、Codex 说话，就算会做项目了。

但真正跑过几次项目就会发现，代码能生成只是第一步。后面还有一堆更现实的问题：

项目放在哪里？

改坏了怎么回退？

怎么把本地代码同步到云端？

别人给你分享的开源项目，应该从哪里看起？

这些问题绕不开一个你肯定经常听到的名字：GitHub。

它听起来像程序员专属网站，但现在，它已经成为了 AI 编程新手的项目工作台。

你不一定要成为专业开发者，但至少要知道 GitHub 是什么、怎么找项目、怎么建仓库、怎么把 Agent 写出来的东西保存下来。

这篇我就按最小可用闭环讲一遍。目标不是让你背命令，而是让你知道每一步在解决什么问题。

看完之后，你最少要掌握以下这条线：

注册账号 → 开双重认证 → 建第一个仓库 → 学会搜索项目 → 看懂 README 和 Issues → 让 Agent 帮你提交、推送、部署。

AI 编程新手的 GitHub 最小闭环

一、先分清：开源、Git、GitHub，不是一回事

很多人一上来就被 GitHub 吓住，是因为几个词混在了一起。

先说开源。

代码本质上也是文字。你写一个程序，其实就是写了一堆文本文件。不开源，就是这些文件只放在你电脑里，别人看不到。开源，就是你把它们放到公开仓库里，允许别人查看、复制、学习，甚至继续修改。

但开源不等于把所有权都扔掉。

你依然可以通过许可证规定别人怎么用。比如 MIT 协议相对宽松，GPL 协议更强调“你用了我的开源代码，你自己的部分也要按规则开源”。如果什么许可证都不写，法律上默认仍然保留权利，只是实际协作会变得不清楚。

再说 Git。

Git 是装在本地的版本控制工具。它像一个非常严格的项目记录本，会记住你每一次修改了什么、什么时候改的、能不能退回去。

最后是 GitHub。

GitHub 是云端平台。它负责把 Git 仓库放到网上，让你能备份、协作、分享、部署。

一句话记住：

Git 是本地版本记录本，GitHub 是这本记录本的云端仓库和协作平台。

开源、Git、GitHub 的区别

新手不需要一开始就理解所有底层命令，但一定要理解这个关系。不然你会把“代码生成了”误以为“项目完成了”。

二、注册账号时，别把它当临时网站账号

打开 GitHub，点 Sign up 注册。

这里最容易被忽略的是三件事。

第一，邮箱尽量用长期稳定邮箱。

如果你后面要用 Vercel、Supabase、Cloudflare、Google OAuth 这些工具，一个稳定邮箱会少很多麻烦。很多海外开发工具也支持 Google 账号登录，所以 Gmail 会更顺手。

第二，用户名别乱起。

GitHub 用户名以后会出现在你的仓库链接里，也会出现在你部署、展示和开源协作的很多地方。

别用 test001、abc123 这种临时名字。用你长期会用的英文 ID，或者清晰的拼音/品牌名。

第三，密码交给密码管理器。

GitHub 不是普通内容网站。它绑定的是你的代码、项目、密钥、协作记录。密码不要复用，也不要靠脑子硬记，最好的办法就是生成一串建议密码，然后交给Chrome或者苹果密码等管理器帮你记录。

注册完以后，立刻开2FA双重认证。

路径是：头像 → Settings → Password and authentication → Two-factor authentication。

推荐用 Authenticator App。绑定以后，每次登录除了密码，还要输入手机 App 里的动态验证码。

还有一个关键动作：保存恢复码。

GitHub 会给你一组恢复码。手机丢了、验证器删了，这组码就是找回账号的救命绳。放进密码管理器，或者离线保存一份。

三、第一个仓库，只要先建对基本骨架

有了账号，下一步是建仓库。

仓库就是一个项目的容器。一个网站、一个工具、一个脚本、一个实验项目，都可以是一个仓库。

点右上角加号，选择 New repository。

新手建仓库时，先记住几条简单规则。

仓库名用英文小写，单词之间用连字符。

比如 my-first-project，不要用中文，也不要用一串看不懂的临时代码。

Description 写一句话。

这不是给别人看的面子工程，也是给未来的自己看的。三个月后你再打开仓库，能一眼知道这个项目干什么。

Public 和 Private 按用途选。

公开仓库任何人能看到，私有仓库只有你和被邀请的人能看到。练习项目、作品展示、开源模板可以公开；带密钥、客户数据、商业逻辑的项目要私有。

README 建议勾上。

README 是仓库首页的说明书。没有 README 的仓库，就像一个没有门牌的房间。别人点进来不知道项目是干什么的，你自己以后也很容易忘。

License 不确定可以先不选。

如果你明确想开源给别人用，再认真选许可证。

四、会搜索 GitHub，比收藏一百篇教程更有用

GitHub 最强的能力之一，是搜索真实项目。

在 AI 时代，可以说 Github 已经成为了最全面且更新最快的项目搜索引擎。

你想找一个 AI 工具、一套模板、一个参考实现，不一定要先去搜索引擎里翻 SEO 文章。直接在 GitHub 搜，往往更快。

几个搜索语法先记住：

language:python

只看 Python 项目。

stars:>1000

只看 Star 超过 1000 的项目。

pushed:>2026-01-01

只看今年还在更新的项目。

in:name

只看仓库名里包含关键词的结果。

它们可以组合使用。

比如你想找 Python 写的、Star 超过 5000、今年还在更新的机器学习项目，可以搜：

machine learning language:python stars:>5000 pushed:>2026-01-01

这比“某某项目推荐”更接近一手资料。

对 AI 编程新手来说，GitHub 搜索不是炫技，而是找参照物。你可以看别人怎么写 README，怎么组织文件夹，怎么处理 Issue，怎么发布版本。

五、读懂一个仓库，先看这几个地方

打开一个陌生仓库，不要一上来点进代码文件里硬读。

先看 README。

README 通常会告诉你四件事：

这个项目是什么。

怎么安装。

怎么使用。

有哪些示例或注意事项。

如果一个项目 README 写得非常潦草，安装方式也没有说明，那它可能不是给外部用户准备的。新手不必硬啃，换一个文档更清楚的项目更省时间。

再看 Star、Fork、Watch。

Star 可以理解为收藏和认可。Star 数高不代表一定好，但说明它被更多人看见和使用过。

Fork 是复制一份到自己账号下。你想改别人的项目，通常先 Fork，再在自己的副本里动手。

Watch 是订阅通知。新手一般不用主动打开，否则通知会很多。

接着看 Code、Issues、Pull requests。

Code 是文件区。项目代码、文档、配置都在这里。

Issues 是工单区。别人提 bug、问问题、提需求，都会在这里。你遇到问题时，先搜 Issues，很多坑前人已经踩过。

Pull requests 是合并请求区。别人给项目贡献代码，会在这里提交修改，等待维护者审核。

如果你只是学习一个项目，前期看 README、文件结构和 Issues，就已经够用了。

打开一个仓库先看这 5 个地方

六、本地 Git 操作，可以让 Agent 做，但你要知道在做什么

这一步是 AI 编程新手最容易松一口气的地方：

你不需要一开始背一堆 Git 命令。

如果你用的是 Cursor、Claude Code、Codex、Trae 这类 Agent 工具，可以直接把 Git 操作交给它。

你只要会说清楚这几句话：

帮我初始化 Git 仓库。

把当前项目变成一个 Git 项目。

帮我把这个仓库克隆到本地：https://github.com/xxx/xxx

把别人的项目下载到你的电脑里。

提交所有改动，说明是：修复登录页白屏。

把本次修改记录成一个版本。

推送到 GitHub。

把本地提交同步到云端仓库。

拉一下最新代码。

把远端更新同步到本地。

帮我把这个项目关联到 GitHub 上的 xxx 仓库，然后推送上去。

把本地已有项目和 GitHub 新仓库连起来。

但这里有个边界：

命令可以让 Agent 执行，判断不能完全外包。

不用背 Git 命令，先会对 Agent 说这 6 句话

你至少要知道它是在初始化、提交、推送、拉取，还是关联远端。否则出错时你只会重复一句“帮我修一下”，最后越修越乱。

七、部署上线：GitHub 是很多部署工具的入口

代码推到 GitHub 后，下一步通常是部署。

如果是静态网页，比如 HTML、CSS、简单文档站，可以用 GitHub Pages。部署成功后，你会得到一个类似：

你的用户名.github.io/仓库名

的公开地址。

如果是 React、Vue、Next.js 这类前端项目，更常见的是走 Vercel。

Vercel 会连接你的 GitHub 仓库，自动构建，自动给你一个 vercel.app 域名。以后你每次 push，新版本就会自动部署。

这就是为什么我说 GitHub 是 AI 编程的项目底座。

从 GitHub 到上线地址

不是因为它神秘，而是因为很多后续工具都围绕它协作：代码在 GitHub，部署在 Vercel，域名在 Cloudflare，数据在 Supabase，整条链路才能跑起来。

八、Fork 和 Pull Request，是进入开源协作的入口

如果你只是自己做项目，前面的内容已经够用。

但如果你想参与开源项目，就要理解 Fork 和 Pull Request。

Fork 是复制。

你看到一个公开仓库，点 Fork，就会在自己账号下得到一份完整副本。你可以在副本里随便改，不会影响原项目。

Pull Request 是申请合并。

你改完以后，把修改提交到自己的 Fork 仓库，再向原项目发起 PR。维护者会看到你改了什么，可能直接合并，也可能让你继续修改。

这个过程听起来像程序员内部流程，其实对学习特别有价值。

因为它逼你讲清楚三件事：

你改了什么。

为什么这么改。

这个改动有没有破坏原来的东西。

会写清楚 PR，本质上就是会用工程方式表达问题。

Fork 和 Pull Request 是怎么协作的

九、真正的练习，是找一个项目跑完闭环

学 GitHub 最怕停在“我看懂了”。

真正能让你掌握它的，是跑完一次闭环：

先注册账号，开好 2FA。

再建一个仓库，写好 README。

然后找一个你感兴趣的开源项目，读 README 和文件结构。

接着让 Agent 帮你 clone 到本地。

改一点很小的东西，比如 README 里加一段说明，或者改一个页面文案。

提交。

推送。

如果是网页项目，再部署到 GitHub Pages 或 Vercel。

这条链路跑完，你对 GitHub 的理解会立刻不一样。

它不再是一个满屏英文按钮的网站，而是你的项目从“本地文件夹”变成“可追溯、可同步、可展示资产”的通道。

最后记住一句话

AI 编程时代，GitHub 不是程序员的专属领地。

它更像一个基础工作台。

AI 可以帮你写代码，Agent 可以帮你跑命令，但你的项目要长期生长，必须有仓库、有版本、有说明、有部署地址。

这就是 GitHub 对普通创作者、独立开发者和 AI 编程新手的真实价值。

下一步不用想太多。

打开 GitHub，搜一个你感兴趣的项目。先读 README，再看文件结构。然后 clone 到本地，改一点点，push 上去。

跑过一次，这套东西才会真的变成你的。

AI 编程新手 GitHub 最小闭环