generated from Java-2025Fall/final-vibevault-template
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# 前端开发反思报告 写作指南
|
||
|
||
> **字数**：600–1200 字
|
||
> **形式**：自由叙述，重点展示你的界面和思考
|
||
> **核心**：我们想看到**你的界面设计**和**开发过程中的思考**
|
||
|
||
---
|
||
|
||
## 写作要求
|
||
|
||
请围绕以下 **三个问题** 展开：
|
||
|
||
### 1. 展示你的界面（约 5 分）
|
||
|
||
**必须包含 3–6 张截图**，每张截图下方要有说明：
|
||
|
||
- 截图应覆盖主要功能界面（如歌单列表、创建/编辑、歌曲管理等）
|
||
- 每张截图下方用 2–3 句话说明：
|
||
- 这个界面是做什么的？
|
||
- 用户在这里可以完成哪些操作？
|
||
- 你在这个界面中设计了哪些交互细节？
|
||
|
||
> 💡 截图是前端报告的核心价值，让读者"看到"你的成果。说明要简洁但信息量充足。
|
||
|
||
**📁 截图保存位置**：
|
||
1. 将截图文件保存到仓库根目录下的 `images/` 文件夹
|
||
2. 支持 PNG、JPG、GIF 格式
|
||
3. 建议命名清晰，如 `playlist-list.png`、`create-form.png`
|
||
|
||
**示例格式**：
|
||
```markdown
|
||
|
||
|
||
这是歌单列表页面，用户可以查看所有歌单。我设计了...
|
||
```
|
||
|
||
### 2. 你在前端开发中遇到的最大挑战是什么？（约 3 分）
|
||
|
||
- 描述一个具体的前端问题（如状态管理混乱、组件通信困难、API 对接错误等）
|
||
- 说明你的排查和解决过程
|
||
- 从中学到了什么？
|
||
|
||
> 💡 好的回答会展现真实的前端开发痛点，而不是"一切顺利"。
|
||
|
||
### 3. 如果重新做一遍，你会如何改进？（约 2 分）
|
||
|
||
- 回顾你的前端实现，哪些地方可以做得更好？
|
||
- 如果时间充裕，你会优先改进什么？（如性能优化、响应式设计、代码组织等）
|
||
|
||
> 💡 诚实地承认不足并提出改进思路，这比假装完美更有价值。
|
||
|
||
---
|
||
|
||
## 评分说明
|
||
|
||
| 维度 | 分值 | 评分标准 |
|
||
|------|------|----------|
|
||
| 界面展示 | 5 分 | 截图数量充足(3-6张)、说明清晰、能展现主要功能 |
|
||
| 问题解决 | 3 分 | 问题描述具体、解决过程真实、有明确的学习收获 |
|
||
| 反思改进 | 2 分 | 能识别不足、提出合理的改进思路 |
|
||
|
||
---
|
||
|
||
## 不需要写的内容
|
||
|
||
- ❌ 技术栈的详细罗列（"我用了 React + Vite..."）
|
||
- ❌ 组件结构的详细说明（代码本身会说话）
|
||
- ❌ API 调用的详细代码（除非是为了说明某个问题）
|
||
- ❌ "我学到了很多"之类的空话
|
||
|
||
---
|
||
|
||
## 示例片段
|
||
|
||
> **不好的写法**：
|
||
> "我使用了 React 18，组件分为页面组件和通用组件，状态管理使用了 Context..."
|
||
>
|
||
> **好的写法**：
|
||
> "在实现歌单列表时，我最初把所有数据都放在组件内部 state，导致每次刷新都要重新请求。后来我把数据提升到 Context，不仅减少了重复请求，还能在多个组件间共享状态。这让我理解了状态提升的重要性..."
|