前端基础审查 是做什么的?
“一个组件应该只做好一件事。如果你用‘和’来描述它,就把它拆分。”
何时启用
在审查以下内容时激活此技能:
- React/Vue/Svelte 组件
- UI 渲染逻辑
- 状态管理代码
- CSS/样式决策
- 客户端路由
审查清单
组件架构
- 单一职责:每个组件是否只做一件事?
- 规模检查:组件是否不超过 200 行?
- 属性数量:属性是否少于 7 个?
- 命名:能否在不使用“和”字的情况下描述该组件?
状态管理
- 就近放置:状态是否尽可能靠近使用它的地方?
- 提升状态:兄弟组件之间是否通过父组件正确共享状态?
- Context vs Props:是否避免了属性透传(最多不超过 3 层)?
- 服务端状态:服务端数据是否单独管理(如 React Query/SWR)?
性能
- 记忆化:昂贵的计算是否包裹在 useMemo 中?
- 回调:事件处理器是否在需要时包裹了 useCallback?
- 重渲染:是否会导致不必要的重渲染?
- 懒加载:重型组件是否进行了代码分割?
无障碍
- 语义化 HTML:是否使用了正确的元素(如 button vs div)?
- ARIA:交互元素是否无障碍?
- 键盘:用户能否不使用鼠标进行导航?
常见错误(反模式)
1. God 组件
❌ UserDashboard.tsx (1000 行)
- 获取数据、管理状态、渲染 UI、处理路由
✅ 拆分为:
- UserDashboardPage.tsx(容器)
- UserStats.tsx(展示)
- UserActivity.tsx(展示)
- useUserData.ts(自定义 Hook)
2. 渲染内联逻辑
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. 属性透传
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // 在 Widget.tsx 中
4. 布尔属性混乱
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
苏格拉底式提问
向初级开发者提问这些问题,而不是直接给出答案:
- 架构:“这个组件的单一职责是什么?”
- 拆分:“如果要求你单独使用头部部分,你能做到吗?”
- 状态:“谁需要这些数据?它应该放在这里还是更高层?”
- 性能:“当父组件重新渲染时会发生什么?”
- 复杂度:“一个新开发者能在 5 分钟内理解这个吗?”
标准参考
详细模式见:
/standards/frontend/component-architecture.md
需要预警的标记
| 标记 | 需要提出的问题 |
|---|---|
| 文件超过 200 行 | “我们能把它拆分成更小的部分吗?” |
| 超过 5 个 useState 调用 | “是否应该提升或合并部分状态?” |
| useEffect 依赖为空数组但使用了外部值 | “是否缺少依赖项?” |
| 直接操作 DOM | “有 React 的做法吗?” |
| 到处使用内联样式 | “是否应该使用统一的样式方案?” |