# 前端开发反思报告 写作指南

> **字数**：600–1200 字  
> **形式**：自由叙述，重点展示你的界面和思考  
> **核心**：我们想看到**你的界面设计**和**开发过程中的思考**

---

## 写作要求

请围绕以下 **三个问题** 展开：

### 1. 展示你的界面（约 5 分）

**必须包含 3–6 张截图**，每张截图下方要有说明：

- 截图应覆盖主要功能界面（如歌单列表、创建/编辑、歌曲管理等）
- 每张截图下方用 2–3 句话说明：
  - 这个界面是做什么的？
  - 用户在这里可以完成哪些操作？
  - 你在这个界面中设计了哪些交互细节？

> 💡 截图是前端报告的核心价值，让读者"看到"你的成果。说明要简洁但信息量充足。

**📁 截图保存位置**：
1. 将截图文件保存到仓库根目录下的 `images/` 文件夹
2. 支持 PNG、JPG、GIF 格式
3. 建议命名清晰，如 `playlist-list.png`、`create-form.png`

**示例格式**：
```markdown
![歌单列表页面](images/playlists.png)

这是歌单列表页面，用户可以查看所有歌单。我设计了...
```

### 2. 你在前端开发中遇到的最大挑战是什么？（约 3 分）

- 描述一个具体的前端问题（如状态管理混乱、组件通信困难、API 对接错误等）
- 说明你的排查和解决过程
- 从中学到了什么？

> 💡 好的回答会展现真实的前端开发痛点，而不是"一切顺利"。

### 3. 如果重新做一遍，你会如何改进？（约 2 分）

- 回顾你的前端实现，哪些地方可以做得更好？
- 如果时间充裕，你会优先改进什么？（如性能优化、响应式设计、代码组织等）

> 💡 诚实地承认不足并提出改进思路，这比假装完美更有价值。

---

## 评分说明

| 维度 | 分值 | 评分标准 |
|------|------|----------|
| 界面展示 | 5 分 | 截图数量充足(3-6张)、说明清晰、能展现主要功能 |
| 问题解决 | 3 分 | 问题描述具体、解决过程真实、有明确的学习收获 |
| 反思改进 | 2 分 | 能识别不足、提出合理的改进思路 |

---

## 不需要写的内容

- ❌ 技术栈的详细罗列（"我用了 React + Vite..."）
- ❌ 组件结构的详细说明（代码本身会说话）
- ❌ API 调用的详细代码（除非是为了说明某个问题）
- ❌ "我学到了很多"之类的空话

---

## 示例片段

> **不好的写法**：
> "我使用了 React 18，组件分为页面组件和通用组件，状态管理使用了 Context..."
>
> **好的写法**：
> "在实现歌单列表时，我最初把所有数据都放在组件内部 state，导致每次刷新都要重新请求。后来我把数据提升到 Context，不仅减少了重复请求，还能在多个组件间共享状态。这让我理解了状态提升的重要性..."
