【TraeCode 上手记】我用 TraeCode 做了一个给编程小白的 Git 修炼场

上一次AI创造力大赛,我看到很多同学都遇到代码开发过程中突然改崩了。上下文管理不合理遭遇项目代码被没了。再想补救耽误时间又很难受。TRAE友们推荐恢复git版本。发现也有很多小伙伴对 Git 一直处于“知道它很重要,也用过几个命令,却没有真正串起来”的状态,甚至对git只是单纯知道而已。

网上的 Git 教程很多,不过大部分一上来就是 initaddcommitpush。单独看每条命令好像都能看懂,真轮到自己操作时,又不知道现在应该用哪一条。

所以这次我想试着做一个不靠死记命令的 Git 教学网站:让学习者从创建第一个网页开始,在具体场景里理解 Git

我想做的不是命令手册

我最开始给 TraeCode 提的需求其实很普通:做一个面向零基础用户的 Git 教学网页。

但继续整理后,我发现真正的问题不是“页面怎么写”,而是教学顺序。

如果用户连 Git、GitHub 和部署分别是什么都没搞清楚,直接给他一串命令,最后还是容易混在一起。因此我又补充了一个要求:

每一步都要先解释当前遇到了什么问题、为什么需要这条命令、做完会改变什么,以及不会发生什么,然后再让用户操作。

这个要求希望实现:要知其然,更要知其所以然。后来也成了整个项目最重要的一条设计思路。

我是怎么慢慢把 TraeCode 用顺的

一开始我也会把很多想法一起发过去,希望它一次把整个网站做完。这样虽然很快能看到页面,但细节容易偏,自己也不容易判断问题出在哪里。

后来我改成了分阶段推进。

先让 TraeCode 帮我梳理学习路线,把内容分成“基础、进阶、复杂”三条线路;再做一节“0 号课”,先讲清楚 Git、GitHub 和部署的区别;接着才开始做真正可以操作的教学沙盘。

每完成一部分,我都会打开页面实际走一遍,再继续补充要求:

  • 新手第一次打开时,能不能知道从哪里开始?

  • 输入一条命令以后,文件状态有没有跟着变化?

  • commit 完成后,页面有没有明确说明代码还没有上传到 GitHub?

  • 输错命令时,是只显示报错,还是能告诉用户下一步应该怎么做?

  • 手机和不同大小的窗口里,内容还能不能正常使用?

这样一段一段调整以后,我发现 TraeCode 最适合我的用法并不是“给一句话,然后等最终结果”,而是把它当成一个可以一起分析、实现和检查项目的搭档。

我负责判断这个功能对新手有没有帮助,TraeCode 帮我快速定位相关代码、完成修改,并把页面跑起来检查。遇到不符合预期的地方,我不用重新讲完整个项目,只要说清楚当前页面、当前问题和希望发生的变化,沟通就顺很多了。

最后做成了什么

最后完成的是一个基于 React 和 Vite 的互动教学网站,我给它起名叫“Git 修炼场”。

它不是让用户在真实项目里直接执行命令,而是提供了一个安全的模拟开发工作台。用户可以在里面:

  • 创建项目文件夹和 index.html

  • 填写网站标题、介绍文字并生成网页

  • 一边看网页预览,一边观察文件状态

  • 依次练习 git initgit statusgit add .git commit

  • 观察文件从“未跟踪”到“已暂存”,再到“已提交”的变化

  • 模拟创建 GitHub 仓库并完成第一次 push

  • 继续学习分支、团队协作、冲突处理、撤回和部署

我还专门加了一张完整路线图:

“修改文件 → 暂存 → 本地提交 → 推送到 GitHub → 部署上线”。

以前我总容易把这些步骤混在一起。项目做完以后,我自己反而先把 Git 的主线重新学明白了。

想给后来的人留一句建议

如果你也想用 TraeCode 做一个项目,我的建议是:不要只告诉它“帮我做一个网站”,也不用一开始就把所有技术细节都想好。

先把三件事说清楚:

  1. 这个项目是给谁用的;

  2. 用户现在真正遇到了什么问题;

  3. 做完以后,用户应该能够完成什么。

然后把项目拆成几段,每完成一段就亲自打开、操作和检查一次。发现问题时,把具体页面、操作步骤和预期结果告诉它。

我这次最大的感受是,TraeCode 可以很快帮我把想法变成能运行的东西,但“这个东西到底对用户有没有用”,还是需要自己不断体验和判断。

对我来说,这次不只是做出了一个 Git 教学网站,也找到了一种更适合自己的 AI 编程方式:先想清楚问题,再让工具帮我一步一步把它做出来。


刷到这个想起来把我项目同步一下gitlab,不然又要被说了

1 个赞

其实我还写了一个自动提交GitHub的skill。但是近期没啥项目,还没实践准确度

1 个赞

不错诶!!!

虽然但是我觉得这个已经很清晰了 :nerd_face:

但是很多人,甚至都不看它一眼 :distorted_face: