Skip to content

5.4.5 从项目到作品集

经过本节学习,你将掌握:

  • 为什么要把项目整理成作品集
  • 如何写一个清晰的项目说明(README)
  • 记录学习心得的模板
  • 下一步可以尝试什么项目

你的待办清单可以成为什么

完成第四章和第五章后,你手上有的不只是"一个练习",而是:

它可以是怎么用
学习成果的证明告诉别人你做了什么、学会了什么
求职/升学的作品面试时展示你的动手能力
继续学习的基础在这个项目上尝试新技术
帮助他人的工具分享给有类似需求的人

但前提是——你需要把它整理出来,让别人能看懂。

写一个项目说明(README)

README 是放在项目根目录的一个文件,用来介绍这个项目是什么、怎么用。

当别人打开你的 GitHub 仓库时,第一眼看到的就是 README。

简单的 README 模板

在你的项目根目录创建一个 README.md 文件,内容可以这样写:

markdown
# 我的待办清单

一个简洁的任务管理工具,帮你记录和追踪日常待办事项。

## 功能

- 添加新任务
- 标记任务完成
- 删除任务
- 任务数据自动保存(刷新不丢失)

## 在线体验

访问:[你的网址.zeabur.app](https://你的网址.zeabur.app)

## 技术栈

- HTML
- CSS
- JavaScript
- localStorage(本地存储)

## 我学到了什么

这是我用 AI 辅助编程完成的第一个项目。在这个过程中,我学会了:

1. 用自然语言和 AI 沟通需求
2. 把想法分解成具体的功能点
3. 测试和调试代码
4. 使用 GitHub 管理代码版本
5. 将网页部署到互联网

## 关于作者

[你的名字],一个正在学习 Vibe Coding 的普通人。

让 AI 帮你写 README

如果不知道怎么写,可以让 AI 帮忙:

我做了一个待办清单项目,请帮我写一个 README 文件。

项目功能:
- 添加任务
- 删除任务
- 标记完成
- 本地存储

技术栈:HTML + CSS + JavaScript

访问地址:[你的网址]

请用简洁的中文,包含项目介绍、功能列表、在线体验链接、技术栈说明。

截图展示

一张好的截图胜过千言万语。

建议准备:

截图类型展示内容
主界面整体页面效果
功能演示添加任务、完成任务等操作
移动端适配手机上的显示效果(如果做了响应式)

如何截图

  • 网页截图:使用浏览器自带的截图功能,或者按 F12 打开开发者工具,选择"设备模式"可以模拟手机界面
  • 录屏:可以录一个 10-20 秒的操作演示,上传到 GitHub 或转成 GIF

记录学习心得

除了项目本身,你的学习过程也很有价值。

学习心得模板

markdown
## 我的学习心得

### 最大的收获
这个项目让我意识到,编程不是"会写代码",而是"会清晰地表达需求"。
当我把想法说清楚了,AI 就能帮我实现。

### 遇到的挑战
1. 一开始不知道怎么描述需求,总是说得很模糊
2. AI 给的代码有时候不能直接用,需要调试
3. 第一次用 GitHub 有点懵,但习惯了就好

### 怎么解决的
1. 用 S.C.A.F.F. 框架组织我的 Prompt,说清楚情境和目标
2. 把错误信息发给 AI,让它帮我修复
3. 按照教程一步步操作,不懂的地方多试几次

### 下一步计划
- 给待办清单添加分类标签功能
- 尝试做一个记账小工具
- 继续学习进阶版教程

这些心得不仅能帮你复盘,也能帮助和你一样的学习者。

下一步可以尝试的项目

完成待办清单后,你可以挑战这些项目:

项目难度为什么适合
习惯打卡器⭐⭐和待办清单类似,但增加了日期维度
记账小工具⭐⭐学习处理数字和简单统计
个人书签管理⭐⭐学习处理链接和分类
读书笔记⭐⭐⭐学习处理更多文本内容
给家人做的工具⭐⭐真实用户,真实反馈

挑一个你感兴趣的,用同样的方法再做一遍。每做一个项目,你就更熟练一点。

进阶版预告

如果你想做更复杂的项目,比如:

  • 需要用户登录
  • 需要多人协作
  • 需要后端数据库
  • 需要更专业的界面

这些内容会在**进阶版《Vibe Coding 全栈实战教程》**中详细讲解。

基础版让你入门,进阶版让你更强。

本节检查清单

  • [ ] 为项目写了 README 文件
  • [ ] 准备了项目截图
  • [ ] 记录了学习心得
  • [ ] 想好了下一个要做的项目

本章总结

恭喜你完成了 5.4 节的全部内容。

回顾一下你在这一节学到的:

主题你掌握了
迭代思维完成只是开始,持续改进才是关键
收集反馈让真实用户帮你发现问题
功能扩展用 S.C.A.F.F. 框架让 AI 帮你加功能
代码优化让 AI 帮你改进代码质量
作品展示把项目整理成可分享的作品

你的待办清单,从第四章的"能用",变成了现在的"好用"、"可展示"。

这是一个了不起的进步。

创造者的身份

从现在起,你不再只是一个"用户"。

你是一个能把想法变成现实的创造者

继续做下去,你会越来越强。

5.5 知边界:Vibe Coding 的能与不能