安全解构需用可选链与空值合并，归一化字段名和类型，过滤前置降负载，key 必须稳定唯一。
map 里直接解构嵌套对象容易丢字段
很多人写 map 时习惯一口气解构到底，比如 item.user.profile.name，但只要中间某层是 null 或 undefined，整个表达式就报 Cannot read property 'profile' of undefined。这不是 map 的问题，是 JavaScript 访问链断裂的通病。
安全做法是逐层可选链 + 默认值兜底：
data.map(item => ({
id: item.id ?? 0,
userName: item.user?.name ?? '未知用户',
avatar: item.user?.avatar?.url ?? '/default-avatar.png',
tags: Array.isArray(item.metadata?.tags) ? item.metadata.tags : []
}))
- 用
?.避免访问空引用，比&&更简洁可靠 -
??比||更适合处理0、''等假值场景 - 数组字段务必加
Array.isArray判断，后端字段类型不一致太常见
归一化字段名和类型必须提前对齐组件接口
组件接收的 props 名（比如 userDisplayName）和原始数据字段（比如 display_name）不一致，硬塞进去会导致组件渲染异常或 prop-types 警告。别指望组件自己适配——它只认约定好的契约。
归一化不是“改个名字”，而是建立映射关系：
data.map(item => ({
// 组件要求的 key
userDisplayName: item.display_name || item.name,
isVerified: Boolean(item.verified_at),
lastActive: new Date(item.last_active * 1000), // 时间戳转 Date 实例
statusColor: item.status === 'active' ? 'green' : 'gray'
}))
- 布尔值统一用
Boolean()或!!转换，避免'true'字符串被当真 - 时间字段优先转成
Date对象，组件用toLocaleString()更可控 - 状态映射别写死字符串，抽成常量或配置对象，后续加状态时不用翻遍
map
分发前做浅过滤比在组件里 if-else 更轻量
如果组件只接收「已激活且有头像」的用户，把过滤逻辑放在 map 外面、归一化之前，能减少无效计算和冗余对象创建。
错误示范：data.map(...).filter(...) —— 先造一堆对象再扔掉
正确顺序：
data
.filter(item => item.status === 'active' && item.avatar?.url)
.map(item => ({ /* 归一化 */ }))
- 过滤条件越早执行，
map处理的数据量越小，尤其面对几百条以上列表时明显 - 注意：
filter不能替代归一化里的字段兜底，两者职责不同 - 如果过滤逻辑复杂（比如依赖异步结果），那就得拆成两步，别硬塞进
map
React 中 map 返回 jsx 时 key 不要取 index
用 map 渲染列表时，key 写成 index 看似省事，但一旦数据排序、增删，React 就会复用错 DOM 节点，导致输入框失焦、动画错乱、状态错位。
必须用稳定唯一标识：
normalizedData.map(item => (
<usercard key="{item.id}" data="{item}"></usercard>
))
- 没有服务端 ID？前端生成
crypto.randomUUID()（仅开发/临时场景） - 千万别用
Math.random()，每次 render 都变，完全失去 key 意义 - 如果归一化后丢失了原始 ID，回溯补上——宁可多一次查找，也别用 index
归一化本身不难，难的是每一步都得想清楚：这个字段组件真需要吗？这个类型它能安全消费吗？这个 key 下次排序还指得对人吗？漏掉一个，后面 debug 就得花十倍时间找。
