第二册
第二册项目练习册
第二册配套练习表,帮助你记录项目地图、终端运行、依赖环境、保存数据、历史记录、Git 保存点和最终验收。
使用说明
这本练习册不是考试卷。
它是你的“项目操作记录本”。
第一册练的是:
我想做什么。
第二册练的是:
我的项目在哪里、怎么运行、怎么保存、怎么验收、怎么继续改。
建议用法:
- 学第 1 课时,填写项目地图。
- 学第 2 课时,填写终端运行记录。
- 学第 3 课时,观察
package.json。 - 学第 4 课时,排查依赖和环境变量。
- 学第 5 课时,判断要保存什么数据。
- 学第 6 课时,记录历史记录功能。
- 学第 7 课时,留下 Git 保存点。
- 学第 8 课时,完成第二册总验收。
练习 1:我的项目地图
先把项目从“一个陌生文件夹”变成“我能说清楚的地方”。
| 项目 | 我的记录 |
|---|---|
| 项目名称 | |
| 项目文件夹在哪里 | |
| 我用什么编辑器打开 | |
| 主要页面文件可能在哪里 | |
| 配置文件可能在哪里 | |
| 启动命令可能在哪里 | |
| 我最看不懂的文件夹是 |
请让 AI 帮你解释,但先不要让它改代码。
练习 2:终端运行记录卡
每次项目跑不起来,先记录,不要慌。
| 项目 | 我的记录 |
|---|---|
| 我在哪个文件夹打开终端 | |
| 我输入的命令 | |
| 终端显示的地址 | |
| 浏览器打开的地址 | |
| 运行是否成功 | 成功 / 失败 |
| 如果失败,错误信息在哪里 | 终端 / 浏览器 / 两边都有 |
| 错误信息全文 |
提醒:
终端不是黑客窗口。
终端是项目说话的地方。
练习 3:package.json 观察表
打开 package.json,找到和运行项目有关的信息。
| 我看到的内容 | 我的记录 |
|---|---|
| 项目名 | |
| scripts 里有哪些命令 | |
| 启动命令是哪一个 | |
| build 命令是哪一个 | |
| 主要依赖有哪些 | |
| 我看不懂的依赖是 |
如果看不懂,可以问 AI:
请用完全不会代码的人也能听懂的话,解释这个 package.json 里 scripts 和 dependencies 分别是什么意思。
练习 4:项目环境排查表
项目跑不起来时,先判断是哪类问题。
| 问题类型 | 我的观察 | 是否可能 |
|---|---|---|
| 没装依赖 | 终端提示找不到包或模块 | 是 / 否 |
| 命令输错 | 终端提示没有这个 script | 是 / 否 |
| 端口被占用 | 终端提示端口冲突 | 是 / 否 |
| 环境变量缺失 | 终端提示 API Key 或 env | 是 / 否 |
| 代码报错 | 终端或浏览器显示文件和行号 | 是 / 否 |
| 文件夹不对 | 命令在错误目录运行 | 是 / 否 |
不要急着重做项目。
先把错误分类清楚。
练习 5:依赖和环境变量记录卡
| 项目 | 我的记录 |
|---|---|
| 是否已经安装依赖 | 是 / 否 / 不确定 |
| 安装依赖命令 | |
是否需要 .env 文件 | 是 / 否 / 不确定 |
| 需要哪些环境变量名 | |
| 哪些值不能公开 | |
| AI 让我新增了什么依赖 | |
| 我知道为什么要新增吗 | 知道 / 不知道 |
注意:
API Key、密码、密钥不要发到公开地方。
练习 6:我要保存什么数据
不要先问“用什么数据库”。
先问:
我要保存什么?
刷新后还要不要存在?
给谁看?
重要吗?
| 数据 | 是否要保存 | 刷新后要保留 | 是否敏感 | 第一版保存位置 |
|---|---|---|---|---|
| 用户输入 | 是 / 否 | 是 / 否 | 是 / 否 | |
| 生成结果 | 是 / 否 | 是 / 否 | 是 / 否 | |
| 生成时间 | 是 / 否 | 是 / 否 | 是 / 否 | |
| 标题或备注 | 是 / 否 | 是 / 否 | 是 / 否 | |
| 其他 | 是 / 否 | 是 / 否 | 是 / 否 |
第二册第一版通常选择:
浏览器本地保存。
练习 7:历史记录功能卡
给小工具加历史记录之前,先写清楚第一版只做什么。
| 功能 | 本课是否做 | 结果 |
|---|---|---|
| 保存一条记录 | 做 / 不做 | 通过 / 不通过 |
| 显示历史记录列表 | 做 / 不做 | 通过 / 不通过 |
| 刷新后记录还在 | 做 / 不做 | 通过 / 不通过 |
| 删除单条记录 | 做 / 不做 | 通过 / 不通过 |
| 清空全部记录 | 可选 / 不做 | 通过 / 不通过 |
| 登录 | 不做 | |
| 云数据库 | 不做 | |
| 部署上线 | 不做 |
测试记录:
| 项目 | 我的测试内容 |
|---|---|
| 测试输入 | |
| 测试输出 | |
| 保存后是否显示 | 是 / 否 |
| 刷新后是否还在 | 是 / 否 |
| 删除后是否消失 | 是 / 否 |
练习 8:AI 修改记录表
每次 AI 改完项目,都记录一次。
| 项目 | 我的记录 |
|---|---|
| 这次让 AI 做什么 | |
| AI 改了哪些文件 | |
| 新增了哪些文件 | |
| 删除了哪些文件 | |
| 我看懂的改动 | |
| 我没看懂的改动 | |
| 项目还能启动吗 | 能 / 不能 |
| 原功能还在吗 | 在 / 不在 / 不确定 |
如果“我没看懂的改动”很多,不要继续加功能。
先让 AI 解释。
练习 9:Git 保存点记录
留下保存点前,先检查项目状态。
| 检查项 | 我的结果 |
|---|---|
| 项目能启动 | 通过 / 不通过 |
| 页面能打开 | 通过 / 不通过 |
| 原功能还在 | 通过 / 不通过 |
| 历史记录能保存 | 通过 / 不通过 |
| 刷新后历史记录还在 | 通过 / 不通过 |
| 能删除历史记录 | 通过 / 不通过 |
| AI 改动我大概知道 | 通过 / 不通过 |
保存点记录:
| 项目 | 我的记录 |
|---|---|
| 保存点说明 | |
| 保存时间 | |
| 保存前完成的功能 | |
| 保存后下一步只改什么 |
保存点说明示例:
完成:历史记录本地保存和删除
练习 10:第二册总验收卡
| 检查项 | 结果 | 证据 |
|---|---|---|
| 项目能正常启动 | 通过 / 不通过 | |
| 页面能正常打开 | 通过 / 不通过 | |
| 第一册原有功能还在 | 通过 / 不通过 | |
| 能生成或整理结果 | 通过 / 不通过 | |
| 能保存历史记录 | 通过 / 不通过 | |
| 刷新后历史记录还在 | 通过 / 不通过 | |
| 能删除不需要的记录 | 通过 / 不通过 | |
| 删除后刷新不会回来 | 通过 / 不通过 | |
| 能说清主要文件 | 通过 / 不通过 | |
| 能说清运行命令 | 通过 / 不通过 | |
| 留下 Git 保存点 | 通过 / 不通过 | |
| 下一步只选一个小目标 | 通过 / 不通过 |
练习 11:第二册复盘
| 问题 | 我的复盘 |
|---|---|
| 我的小工具现在能做什么 | |
| 它比第一册多了什么能力 | |
| 我现在知道项目怎样启动吗 | 知道 / 不知道 |
| 我现在知道数据怎样保存吗 | 知道 / 不知道 |
| 我现在知道 AI 改了什么吗 | 知道 / 不知道 |
| 我留下保存点了吗 | 留了 / 没留 |
| 第二册最难的一课是 | |
| 下一步只改一件事 |
第二册复盘的重点不是炫耀功能。
重点是确认:
我开始能维护自己的小工具了。