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 帮你改进代码质量 |
| 作品展示 | 把项目整理成可分享的作品 |
你的待办清单,从第四章的"能用",变成了现在的"好用"、"可展示"。
这是一个了不起的进步。
创造者的身份
从现在起,你不再只是一个"用户"。
你是一个能把想法变成现实的创造者。
继续做下去,你会越来越强。
