我团队里很多小伙伴都已经开始使用 AICoding 去解决项目上的实际问题；
但是还有不少同学，还在靠“不断撤销”或者“手动复制文件夹”来管理 AI 生成的代码。
每次有新的代码版本变化，都拷贝一份做个标记，一段时间下来，本地代码文件数量越来越多。
而且过一段时间回去看，完全忘了哪个版本是哪个🥲。
然而，程序员有一套进行代码备份和版本管理的王牌工具，那就是 GitHub！
🌅
这对小白学 AICoding 至关重要！
GitHub + AI 的能力，不仅能让 AI 帮你管理复杂的工程，还能在 AI 把代码改废时，一键丝滑回到 1 分钟前最完美的那个版本。
今天我用最接地气的大白话，带你 5 分钟通关 AICoding 第一站GitHub。
GitHub 到底能帮你干啥？
简单来说，GitHub 可以帮你做到以下事情：
1-云端备份（Repository）：把你的本地代码文件夹同步到云端。电脑坏了、硬盘烧了，代码都在。
2-进度存档点（Commit）：就像玩游戏插旗子。AI 写的每一段功能，你都可以存个档。
3-后悔药（Rollback）：AI 一通操作猛如虎，运行起来全是土？一键回滚，瞬间回到上一个稳定版本。
接下来，详细展开说一下，每个具体的作用。如果想看实操方法的，可以忽略，直接跳到下一部分。
作用一：云端备份（Repository）
GitHub 的第一个核心用途：把你的本地代码文件夹同步到云端。电脑坏了、硬盘烧了，代码都在。
为了方便理解，我们可以用一个特别简单的比喻来理解。
你就想象一下，你电脑上有一个文件夹，里面装着你让 AI 写的所有代码。
这个文件夹在程序员的行话里叫“存储库”（Repository，简称 Repo）。
相当于给你的本地代码文件夹搞了个云备份！这样就算你的电脑坏了，手误删除了，代码也不会丢了！
作用二：进度存档点（Commit）
简单来说，版本控制就是给你的代码一个拥有无数存档点的时间机器，就像玩游戏插旗子。
AI 写的每一段功能，你都可以存个档。
打个比方。版本控制就像《超级马里奥》游戏里的“存档旗子”。
每完成一小部分工作，就可以在 GitHub上插一个“旗子”，这个操作叫 commit（提交）。
假如某一次 AICoding大改特改，做了个 V2版本，结果发现越改越糟糕，代码给直接改废了。这时候怎么办？
有了这些检查点，你就能一键放弃 V2，瞬间“回滚”（Rollback）到稳定好用的 V1版本。
作用三：协作，不再单打独斗
软件开发早就不是单打独斗的时代了。把代码放云上，意味着，你可以跟别人一起开发。
GitHub允许你和你的朋友，甚至全世界的陌生人，在同一个代码项目上一起工作。
多人协作，有这样的一些问题存在：
比如，两个人同时改一个文件，A改了第一行，B也改了第一行，最后听谁的？
这就需要提一下 GitHub 处理协作的艺术。
“合并冲突”（Merge Conflicts）的情况是不可避免的，这被很多开发者看作是“噩梦”。
GitHub 有一套机制来处理这种情况。只要掌握了方法，就能让开发速度成倍提升。
新手上路第一步，连接你的GitHub世界
新手如何开始使用 GitHub。很多人往往都卡在第一步：把本地电脑和云端的 GitHub 连起来。
这第一步，也就是基础设置，是重中之重，也是最多人放弃的地方。
其实，只需要设置SSH 密钥。之后，你在本地电脑上所有推送、拉取代码的操作，都会被自动信任，畅通无阻。
步骤非常简单但是繁琐，跟着我一步一步做：
1-注册 GitHub
当然，第一步，你得先注册一个 GitHub 账号。https://github.com/。记下你的 Github 邮箱；
2-生成密钥
打开你电脑的终端（Terminal 或 Cursor 里的 Terminal），输入下面这行命令：
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
-t ed25519：这是一种最新的加密算法，速度快且安全性极高。
-C：这是一个注释，通常写你的 GitHub 邮箱，方便以后你自己分辨这个密钥是给谁用的。
接下来你会看到三次提问，全部直接按【回车键 (Enter)】到底：
Enter file in which to save the key... （询问保存位置，默认就好）
Enter passphrase... （询问是否给密钥加密码，初学者建议不设，直接回车）
Enter same passphrase again... （再次回车确认）
完成后，你会看到一串酷酷的字符画，这意味着你的电脑在 ~/.ssh/ 文件夹下生成了一对文件：
- id_ed25519：私钥（相当于你的身份证原件，绝对不能给别人看）。
- id_ed25519.pub：公钥（相当于身份证复印件，要交给 GitHub）。
3-获取公钥（复制通行证内容）
我们需要把生成的“复印件”内容拷贝出来。在终端输入以下命令查看并显示内容：
cat ~/.ssh/id\_ed25519.pub
你会看到一行以 ssh-ed25519 开头，以你的邮箱结尾的长字符串。完整地选中并复制它。
4-绑定 GitHub（把通行证交给云端）
现在去 GitHub 备案：
登录 GitHub，点击右上角头像 -> Settings 。
在左侧菜单栏找到 SSH and GPG keys 。点击右上角的绿色按钮 New SSH key 。
Title：随便起个名字，比如 "MyMacBookPro" 或 "Cursor-Work"。
Key type：保持默认的 "Authentication Key"。
Key：把你刚才复制的那一大串字符粘贴进去。然后点击 Add SSH key。
5-验证是否成功（最关键的一步）
回到终端，输入这行命令测试连接：
ssh -T git@github.com
如果提示 Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入 yes 并回车。
如果你看到：Hi [你的用户名]! You've successfully authenticated...，恭喜你！连接打通了。
Cursor 玩家专项：手把手带你存档与防翻车
接下来，我以最流行的 AICoding IDE Cursor为例做演示。
你不需要频繁切换窗口。
所有的 Git 操作都可以在编辑器内通过“交互指令”或“可视化面板”完成。
1-存档（Commit）：给 AI 的代码加个“还原点”
当你让 Cursor 写完一个功能，且运行测试通过后，请养成“秒存档”的习惯。
存档的方式有两个：
交互指令（终端流）： 打开终端
然后输入：
git add .
git commit -m "feat: AI 完成了用户中心布局"
但是，既然都说了是 AI 辅助的，我更推荐 Cursor 的可视化流：
1-点击 Cursor 左侧边栏的源代码管理图标（看起来像个分叉的路口）。
初始化代码仓库：点击“Initialize Repository”。
输入类似 1-初始化 这样的备忘记录，点击 Commit。
Cursor 会提醒是否需要保存所有的变化并且提交，点击 Yes 。
你就能在下方的 Graph 上看到 main 这样的字样。
如果有一些阶段性变化要修改，我们可以做一些指定的内容存档。
在 Changes 列表点击 + 号（暂存）。然后，在上方的输入框写下“存档留言”，点击 Commit。
所有在 StagedChanges 里的文件，就会被再次提交。
下方的 Graph 就会出现本次提交的版本了。
注意哟，这个时候咱们保存的代码都是本地状态的。如果咱们需要关联 GigHub 账号推送。需要点击这朵云。
然后，Cursor 顶部，就会出现让我们选择的项目。
目前，我们有两个选项，一个是 Private 私人代码库；另一个是 Public 公共代码库；
这俩区别很明显，咱如果不想公开，就选择 Private。
选择完成后，左下角的 Graph 的状态就变成这样的了。这代表我们当前的最新代码版本和云端的是一致的。
同步完成后，GitHub 上也有了这个代码库：
2-分支（Branch）：大胆让 AI 拆解重构
简单说一下为什么要搞分支。
如果你的代码已经能够稳定运行了。你在 main（主分支）上直接让 AI 大改代码非常危险，因为：
- 不可逆性：如果 AI 修改了多个文件，单纯靠 Cmd+Z 很难彻底恢复。
- 干扰开发：重构通常需要时间调试，在分支上改不会影响你原本可以正常运行的代码。
所以，有新变动之前，请先开一个影子副本。也就是分支Branch；
- 操作步骤：
-
点击 Cursor 界面最左下角的 main 分支名称。右键选择 Create branch。输入名字：简化版本；
此时，你已经进入了一个平行世界，在这里怎么折腾都不会伤到原件。
现在你可以放心地对 Cursor 说：“请帮我优化前端界面”。
这个时候，在分支 Branch 上做的任何 Commit，都在这个平行世界上发生。不会对 Main 有任何影响。
改完后，你有两个选择：
方案 A：重构很完美，准备收工
提交存档：确保你在分支里已经把改动 Commit（提交）了。
在 Cursor 终端输入：git add . 和 git commit -m "3-优化前端界面"。
或者还是使用Change 和 Commit 的方法，保存Branch 变更。
切换回主线：点击左下角的 简化版本 字样，在弹出的顶部菜单中选择 main。
此时，你的代码会瞬间变回重构前的样子（别慌，这是正常的）。
合并代码：
- 点击 Cursor 左侧边栏的 “源代码管理”图标（分叉图标）。
- 点击面板右上角的 三个点 ... (Views and More)。
- 选择 Branch -> Merge Branch...。
- 在顶部的搜索框里选择刚才那个 简化版本 分支。
然后切换回 main 分支（同样点左下角），选择 Merge（合并）刚才的分支。
结果：Cursor 会把两个分支的代码揉在一起。如果没有冲突，你的 main 分支现在就拥有了重构后的新代码。
合并完成后，记得在 Cursor 左下角切换回 main 分支，并执行一次 git pull，同步云端的最新状态
方案 B：重构失败，代码崩了
最爽的操作：点击左下角分支名，直接切回 main。
结果：刚才 AI 产生的所有报错、乱码瞬间消失，你的项目回到了重构前的完美状态。你可以选择删除这个失败的分支，重新开一个再试。
3-后悔药（Reset）：AI 彻底改废了怎么办？
Git 的分支隔离机制就是你的救命稻草。以下是在 Cursor 中通过图形化操作实现“无损回滚”的详细步骤：
🎹
瞬间切换（回滚到完美状态）
比如，这个分支里，我把模型切换成了豆包，执行的时候，提醒我的豆包 API 未配置。
如果你后悔了，不需要手动去删代码，直接执行以下操作：
- 找到入口：点击 Cursor 编辑器最左下角的当前分支名（例如 4-切换豆包模型）。
- 选择目标：在屏幕上方弹出的搜索框列表中，点击选择 main 分支。
- 见证奇迹：你会发现代码立刻恢复到了你开始重构前的样子，右上角变成了API 已连接。
清理现场（删除失败的分支）
既然这个重构方向错了，我们可以把这个“实验室”直接炸掉，不留任何垃圾：
- 打开分支列表：再次点击左下角的 main（确保你现在已经站在主分支上了）。
- 找到失败分支：在列表中找到那个切换模型。
- 确认删除：如果有二次确认弹窗，点击 Delete Branch。
🛡️ 进阶：保护你的敏感信息
还有一个非常重要的安全问题。
如果你的代码里有一些敏感信息，比如数据库密码、API密钥，这些不能让任何人看到。那该如何设置呢？
GitHub 有两个“秘密守护者”文件来帮你。
.gitignore文件
从名字看，就是“Git 忽略”的意思。你在这个文本文件里列出的所有文件名或文件夹名，都不会被git追踪，自然也不会被推送到云端。
2..env文件
这是一个通用的惯例，我们把所有高风险的变量，比如 OPENAI_API_KEY="sk-..."，都写在这个文件里。
那么，如何保护它呢？
最关键的一步：把 .env 这个文件名，写进 .gitignore 文件里。
这样一来，.env 文件本身就永远不会被上传，你的密钥就安全地留在了本地电脑上。这是一个完美的安全闭环。
获取免费代码：站在巨人的肩膀上
最后，留一点时间说一下 GitHub 最棒的地方。
GitHub是个巨大的开发者社区，上面有无数的开源项目。
对，无数的开源项目！
我们在AICoding 的时候，能参考就绝对不要重写！找到一个可以给 AI 参考的 GitHub项目，绝对是事半功倍之选！
很多大神和公司，比如 Google、Microsoft，甚至DeepSeek，会把他们非常先进的模型和工具代码开源，你可以直接下载下来，免费学习和使用（包括给 AI 做参考）。
但GitHub 上的代码质量肯定参差不齐。
如何知道哪个项目靠谱？GitHub 有一套社区评估机制。
主要看两个指标：
-
Star (星标): 类似“点赞”或“收藏”，星星越多的项目通常越受欢迎，质量也更有保障。
-
Fork (派生): 意思是别人把你的代码完整地复制了一份到他自己的地盘上研究或修改。Fork数越多，说明项目越有影响力。
总结：你的代码“时间机器”与“协同建造系统”
GitHub不仅仅是一个复杂的命令行工具，而是一个具备时间机器功能的专业图书馆！
你可以把代码草稿存进去，可以在不同的阅览室（分支）里随便写，写坏了还能用时间机器（回滚）恢复。
而且你的私人笔记（API 密钥）永远不会被公开展览。
对于团队来说，它更像一个高效、安全的协同建造系统。
相信通过这篇超详细的文章，你已经对 GitHub有了全新的、立体的认识。
现在，就去注册一个 GitHub 账号，亲手试试我们今天聊到的这些功能吧！
地址传送门👇：https://github.com/
关于 GitHub，你还有哪些困惑？或者你有什么独家的使用技巧？欢迎在评论区留言分享！👇