上一次AI创造力大赛,我看到很多同学都遇到代码开发过程中突然改崩了。上下文管理不合理遭遇项目代码被没了。再想补救耽误时间又很难受。TRAE友们推荐恢复git版本。发现也有很多小伙伴对 Git 一直处于“知道它很重要,也用过几个命令,却没有真正串起来”的状态,甚至对git只是单纯知道而已。
网上的 Git 教程很多,不过大部分一上来就是 init、add、commit、push。单独看每条命令好像都能看懂,真轮到自己操作时,又不知道现在应该用哪一条。
所以这次我想试着做一个不靠死记命令的 Git 教学网站:让学习者从创建第一个网页开始,在具体场景里理解 Git。
我想做的不是命令手册
我最开始给 TraeCode 提的需求其实很普通:做一个面向零基础用户的 Git 教学网页。
但继续整理后,我发现真正的问题不是“页面怎么写”,而是教学顺序。
如果用户连 Git、GitHub 和部署分别是什么都没搞清楚,直接给他一串命令,最后还是容易混在一起。因此我又补充了一个要求:
每一步都要先解释当前遇到了什么问题、为什么需要这条命令、做完会改变什么,以及不会发生什么,然后再让用户操作。
这个要求希望实现:要知其然,更要知其所以然。后来也成了整个项目最重要的一条设计思路。
我是怎么慢慢把 TraeCode 用顺的
一开始我也会把很多想法一起发过去,希望它一次把整个网站做完。这样虽然很快能看到页面,但细节容易偏,自己也不容易判断问题出在哪里。
后来我改成了分阶段推进。
先让 TraeCode 帮我梳理学习路线,把内容分成“基础、进阶、复杂”三条线路;再做一节“0 号课”,先讲清楚 Git、GitHub 和部署的区别;接着才开始做真正可以操作的教学沙盘。
每完成一部分,我都会打开页面实际走一遍,再继续补充要求:
-
新手第一次打开时,能不能知道从哪里开始?
-
输入一条命令以后,文件状态有没有跟着变化?
-
commit完成后,页面有没有明确说明代码还没有上传到 GitHub? -
输错命令时,是只显示报错,还是能告诉用户下一步应该怎么做?
-
手机和不同大小的窗口里,内容还能不能正常使用?
这样一段一段调整以后,我发现 TraeCode 最适合我的用法并不是“给一句话,然后等最终结果”,而是把它当成一个可以一起分析、实现和检查项目的搭档。
我负责判断这个功能对新手有没有帮助,TraeCode 帮我快速定位相关代码、完成修改,并把页面跑起来检查。遇到不符合预期的地方,我不用重新讲完整个项目,只要说清楚当前页面、当前问题和希望发生的变化,沟通就顺很多了。
最后做成了什么
最后完成的是一个基于 React 和 Vite 的互动教学网站,我给它起名叫“Git 修炼场”。
它不是让用户在真实项目里直接执行命令,而是提供了一个安全的模拟开发工作台。用户可以在里面:
-
创建项目文件夹和
index.html -
填写网站标题、介绍文字并生成网页
-
一边看网页预览,一边观察文件状态
-
依次练习
git init、git status、git add .和git commit -
观察文件从“未跟踪”到“已暂存”,再到“已提交”的变化
-
模拟创建 GitHub 仓库并完成第一次
push -
继续学习分支、团队协作、冲突处理、撤回和部署
我还专门加了一张完整路线图:
“修改文件 → 暂存 → 本地提交 → 推送到 GitHub → 部署上线”。
以前我总容易把这些步骤混在一起。项目做完以后,我自己反而先把 Git 的主线重新学明白了。
想给后来的人留一句建议
如果你也想用 TraeCode 做一个项目,我的建议是:不要只告诉它“帮我做一个网站”,也不用一开始就把所有技术细节都想好。
先把三件事说清楚:
-
这个项目是给谁用的;
-
用户现在真正遇到了什么问题;
-
做完以后,用户应该能够完成什么。
然后把项目拆成几段,每完成一段就亲自打开、操作和检查一次。发现问题时,把具体页面、操作步骤和预期结果告诉它。
我这次最大的感受是,TraeCode 可以很快帮我把想法变成能运行的东西,但“这个东西到底对用户有没有用”,还是需要自己不断体验和判断。
对我来说,这次不只是做出了一个 Git 教学网站,也找到了一种更适合自己的 AI 编程方式:先想清楚问题,再让工具帮我一步一步把它做出来。



