GuideBeginner

在 AI 弄坏你的项目之前,把一切都保存到 GitHub · 你那无限次的撤销按钮

这事发生过,或者将会发生在你身上:你让 AI 做个小改动,它动了四十个文件,突然你那本来跑得好好的应用打不开了。这不总是场灾难——很多工具会保存你的项目——但一条错误的命令、一次误删,或者 AI 的一次大规模改动,确实能让你没法回头。GitHub 是你自己的保险,和工具分开:一键退回到一切还能跑的那一刻,不丢任何东西。它不只是\"给程序员用的\"——它是那张让你不再害怕放手让 AI 深入工作的网。但秘诀不在于搭一次:而在于知道**在哪个时刻**保存,并把它变成一种习惯。这才是你在这里真正学到的东西。

Jun 18, 202611 min

这份指南写给谁?

写给任何用 AI 搭建东西、但还没用 GitHub——或者只用了一半——的人。你不需要会编程。 如果你曾经害怕接受 AI 的某个改动,"生怕它把什么弄坏",这份指南能帮你消除这种恐惧。而且它讲的不只是"这是什么":它会教你在哪些确切的时刻保存,以及怎么把它变成习惯——这恰恰是几乎所有人栽跟头的地方。这里有一条用按钮的路,也有一条通过和你的智能体聊天的路:你自己选。

什么时候会需要它?(那个确切的时刻)

这个需求恰恰出现在你开始用 AI 认真搭建一个真正的应用时——而不是只跟它聊聊天的时候。到了那一步,AI 会同时改动很多文件,而某一天你让它做个小改动,它却无意中弄坏了三个本来好好的东西。就在那一刻你会发现自己到底有没有一张安全网……还是没有。

把恐惧说清楚:是意外,不是末日

说句老实话:并不是每次都"全部被删光"。 很多工具会把你的项目保存在某个文件夹或它们的云端里。真正的问题是另一种,更隐蔽:一条错误的命令、一次误删,或者 AI 的一次大规模改动,损坏了本来能用的东西——如果你没有一个可以退回去的点,那份工作就丢了。GitHub 是你另外一套保险,它不取决于你用哪个工具。

还有第二种阻碍,更微妙:对尝试的恐惧。没有安全网,你只敢提一些畏首畏尾的改动,生怕弄坏什么——而畏首畏尾的改动搭不出任何大东西。有了 GitHub 存档,你就敢放手:出了错,退回去就好。

这样想象一下

GitHub 就是你文本编辑器里的"撤销"功能……只不过是针对你整个项目的,而且没有次数限制。你不是撤销最后一个字,而是把整个项目退回到它昨天、一小时前、或者就在弄坏它的那次改动之前的样子。一台属于你代码的时光机。

Git 是什么,GitHub 又是什么?(各用一句话说清)

Git 是随时间为你的项目拍快照的系统(每张快照叫一个 commit)。GitHub 是你把这些快照上传的云端,让它们安然无恙,并且能退回到任意一张。Git 住在你的电脑里;GitHub 住在互联网上。两者合起来 = 备份 + 时光机。

电子游戏的类比

一个 commit 就是一个存档点,就像电子游戏里那样。往前走,存档。往前走,存档。如果下一关打砸了,你就读取上一个存档,不会丢掉全部进度。这正是你用 GitHub 对你的项目做的事。

你的项目住在哪里?本地文件夹 vs 沙盒

这一点很关键,能帮你理解为什么无论你用什么来搭建,GitHub 都对你有好处。AI 工具用两种方式保存你的项目,而在这两种方式下 GitHub 都是赢家:

本地文件夹——像 Claude Code 这样的工具,是在你自己电脑上的一个文件夹里工作的。要看它跑起来,你就在浏览器里打开那个 localhost。项目是你的,存在你的硬盘上……但如果你误删了它,或者一条命令把它弄坏了,没有云端备份就没法回头。

自带沙盒——另一些工具(比如 NeuralOS、v0、Bolt 之类)会把你的应用跑在它们自己的环境里,你就在那里直接看着它部署好的样子,不用管什么文件夹。极其方便。但你的代码住在那个平台的账号里——如果你想要一份真正属于你自己、无论发生什么都能存活的副本,那就把它放到 GitHub 上。

最要紧的结论

无论是本地文件夹还是沙盒,GitHub 是唯一一份 100% 属于你、且不依赖于工具的备份。 它是你的母版副本。所以两种情况下它都值得——也所以恰恰在你开始认真搭建一个应用时,就该把它接上。

不用终端的路 · GitHub Desktop(推荐新手上手)

如果"终端"这个词让你犯懒,那这就是你的路。GitHub Desktop 是 GitHub 官方的免费应用:它全靠按钮完成一切。你能看到你的改动列表,写一条备注,然后保存——一条命令都不用。它自己的口号就说了:"专注于要紧的事,而不是跟 Git 较劲"。

4 步上手(全靠按钮)

在 github.com 免费注册一个账号(如果还没有的话)。

从 desktop.github.com/download 下载 GitHub Desktop(Mac 和 Windows 都有)。

在应用里打开你的项目:File → Add Local Repository,选中那个文件夹。

点 Publish repository 把它上传到云端。搞定:已经安然无恙了。

从此以后,每当应用给你显示改动时,你就在左下角写一条简短备注(那个 Summary),点 Commit to main,然后 Push origin。这就是一个上传到云端的存档点。每当有东西跑通了,就这么做一次。

GitHub Desktop 是官方的,而且免费

它是开源的,MIT 许可,由 GitHub 本身维护(仓库里超过 2.1 万颗星)。它不是什么花招或第三方应用:它正是 GitHub 为那些不想用命令的人做的工具。

用命令的路 · 4 条价值连城的命令

如果你更喜欢终端(或者你的 AI 替你用),有这四条命令你就掌握了所需的 90%。你的 AI 对它们烂熟于心——你可以让它替你执行,并给你逐条讲解。

1 · 开始追踪你的项目(只做一次)bash

git init
git add .
git commit -m "第一个存档点:项目能跑通"

2 · 查看改了什么(保存之前)bash

git status

3 · 保存一个新的点(每当有东西跑通)bash

git add .
git commit -m "用几个字描述你做成了什么"

4 · 把它上传到云端(真正安然无恙)bash

git push

什么都不用背

最好的窍门:让你的 AI 来做。 跟它说 "把进度用 git 保存下来,写一条描述我们刚做成什么的信息,然后上传到 GitHub",它就替你把命令跑了。你只需要决定什么时候保存。

关键时刻 · 在 AI 弄坏东西时退回去

这就是那项超能力。想象你的应用本来能跑,你让它做了个改动,现在它坏了。如果你在它能跑时保存了一个点,恢复它简直不费吹灰之力。 在 GitHub Desktop 里:History 菜单,在那个好的点上右键 → Revert changes。用命令的话,根据你想要什么有两种做法:

撤销一个改动,靠新建一个把它抵消的改动(安全)bash

git revert HEAD

这条 git revert 是最安全的:它不删历史,只是新建一个点来撤销上一个。如果你只想恢复某一个文件到之前某个点的样子,你就跟你的 AI 说:"把文件 X 恢复到上一个能跑的 commit 里的样子",它会用 git checkout。黄金法则是:

用中文跟你的 AI 说就行

你不用记是 revert、reset 还是 checkout。跟它说:"有东西坏了。把项目恢复到上一个能跑的点的样子,如果可能的话别丢掉我之后的工作。" 你的 AI 会选对命令。GitHub 是那张网;你的 AI 是用它的人。

分支 · 无所顾忌地放开手脚试(可选,但很神奇)

分支是你项目的一份平行副本,你可以在里面尝试,而不碰那个能跑的版本。想让 AI 试点冒险的东西?你建一个分支,让它在那里试,成了就把它合并(merge);砸了就删掉,啥事没有。你的主版本从头到尾都没沾一点风险。

草稿的类比

主分支(main)是你的誊清稿。一个新分支就是一份复印件,你在上面涂涂画画。如果涂画得不错,就把它誊到清稿上。如果不行,就把复印件扔掉。原件始终完好无损。

建一个分支来试验bash

git checkout -b prueba-arriesgada

最要紧的事 · 那 5 个你必须保存的时刻

这就是真正的秘诀,也是几乎没人做的事:GitHub 不是搭一次就完事。它的价值在于习惯。如果你不持续地喂养 GitHub,等你需要它的那天,就没有任何可以退回去的东西。以下是五个保存不容商量的时刻——正是我们这些认真搭建的人所用的那些:

以下情况务必保存……

某个东西跑通了。 你把按钮、界面或流程搞得能用了 → 保存。这是一个你以后会想退回来的点。

在一次大改或冒险改动之前。 你要让 AI 做点大动作 → 先保存。要是砸了,一键退回。

在检查并修好 bug 之后。 你刚审查完、把一切都弄干净了 → 保存这个良好状态。(我们就是这么干的:审查、修复,然后保存。)

每次结束会话时。 你要下线了 → 上传到云端。就算你电脑挂了,你的项目还活着。

在放手让 AI 自己"试验"之前。 你给它放行去尝试 → 先把备份点备好。

一句话总结

错误不在于没有 GitHub。错误在于不喂养它。把它变成条件反射:"跑通了 → 我保存"、"我要动大东西 → 先保存"。每次十秒,顶得上好几个月的工作。

存得干净 · 别把 GitHub 塞满垃圾

好的历史记录是每个点都有意义的记录。两条简单的规则,让你的 GitHub 好用而不是垃圾堆:

存得干净的好习惯

在干净的时刻保存(某东西跑通了或修好了时),别在一个改坏了一半的当口保存。

写让未来的你看得懂的信息:"修好了付款按钮",而不是"改动"或"asdf"。

别上传垃圾文件:依赖(node_modules)、临时文件或密钥(.env)。这些放进 .gitignore(下面会讲)。

一个点 = 一个想法。如果你做了三件不同的事,那就分三次保存、各写各的备注,挺好。

新手常犯的错(以及怎么避开)

别把你的密码上传到 GitHub

如果你的项目在某个文件里(通常叫 .env)有密钥、密码或令牌,它们绝对不能上传到 GitHub。让你的 AI 创建一个 .gitignore 文件,里面写上 .env——这就是告诉 Git "忽略这个,别保存它"。这是头号错误,10 秒钟就能避开。

默认设为私有仓库

发布时,GitHub 会问你这个仓库是公开还是私有。如果这是你的个人或生意项目,就选私有。公开意味着互联网上任何人都能看你的代码。之后可以改,但为了安全起见,一开始就设成私有。

最省事的办法 · 让你的智能体在聊天里替你做

如果你在用一个代码智能体(比如 Claude Code),几乎一切都能在聊天里完成——你不用去背命令。以下是你的智能体能靠一条消息独立完成的事,以及需要你亲手做的那一点点:

谁做什么

智能体在聊天里做的: 创建 .gitignore、第一个存档点、之后所有的存档、上传到云端,以及在有东西坏了时退回去。

你只做一次(5 分钟): 在 github.com 创建你的账号,以及,如果你想手动连接,就在那里创建那个空仓库。有些智能体只要你授权,连这个都能自己搞定。

连接的窍门: 在 GitHub 上创建空仓库,复制它的名字/URL,然后把它交给你的智能体:"把这个项目连接到这个仓库并上传"。剩下的它来做。

仓库怎么命名?

简单点、用小写字母,用连字符代替空格:mi-tienda-online、app-de-recetas、landing-cafe。别带重音符号或奇怪的大写。这个名字只有你(和你邀请的人)看得到。拿不定主意,就直接用你项目的名字。

现成的 prompt · 交给你的 AI,一切就配置妥当

这就是那条完整的 prompt,从头到尾。复制它,替换方括号里的内容,再粘给你的代码智能体。它会帮你把 GitHub 搭好、连好,并养成提醒你保存的习惯。

复制这个,交给你的代码智能体texto

我想用 GitHub 保护我的项目,虽然我不懂 git。请一步一步引导我,能你来做的地方就你来做。我的项目叫 [NOMBRE];我用 [Claude Code / NeuralOS / 其他工具] 搭建它。

1) 账号:如果我没有 GitHub 账号,请用简短的步骤准确告诉我怎么在 github.com 上免费创建。

2) 仓库:告诉我怎么创建一个新的、私有的仓库。根据我项目的名字,给我建议一个用小写字母加连字符的名字。如果你能在我授权下自己创建,就创建;如果不能,就告诉我要点的具体按钮,我把名字或 URL 交给你。

3) 清理:创建一个 .gitignore,忽略 .env、node_modules、临时文件和任何密钥,以免上传垃圾或密码。

4) 第一个点:初始化 git,用一条清晰的信息做第一个 commit,并把它连接并上传到我的私有仓库。

5) 习惯:从现在起,每当我们做成一个能跑通的东西时、在一次大改之前、以及在检查/修复 bug 之后,提醒我保存一个点,并问我要不要把它上传到云端。用清晰的 commit 信息,让未来的我看得懂。

6) 救援:如果有东西坏了,帮我退回到上一个能跑的点,别丢掉我的工作,并用一句话跟我解释发生了什么。

弄简单点。如果有什么只能我自己在网页上做,就告诉我具体要点哪些按钮。

想用的时候再粘一遍

把这条 prompt 存起来。每当你开一个新项目,就再粘给智能体一遍,两分钟内你就把安全网架好了。永远是同一个动作。