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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

git status

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

git push

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

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

git revert HEAD

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

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

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

git checkout -b prueba-arriesgada

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

官方工具(免费且经过验证)