组件与 API 设计（Component & API Design）

设计易用、可扩展、易维护的组件 API 与文件结构，提升后续开发效率。

触发场景

• 用户说「设计这个组件」「组件怎么封装」「API 怎么定」「props 怎么设计」
• 要新建通用组件、业务组件或对现有组件做 API 升级

设计维度

1. 职责单一

• 一个组件只做一类事（展示 / 表单 / 布局 / 反馈）
• 若同时管「数据获取 + 展示 + 复杂交互」，考虑拆成容器 + 展示组件或拆子组件

2. Props 设计

| 原则 | 说明 |