React / 系统课时
列表渲染与 Key
列表渲染与 Key
列表渲染把数组数据转换为一组 React 元素,而 key 决定 React 如何识别每一项。本课通过可反转、可编辑的列表观察稳定 ID 与数组索引作为 key 时的实际差异。
学习目标
- 使用
map()将数组转换为组件列表 - 理解
key在更新与复用组件时的作用 - 识别数组索引作为
key的风险与适用边界
从数组生成元素
React 中通常使用 map() 遍历数据,并为每一项返回 JSX。列表项应把业务数据作为属性传给子组件,同时在同一层级提供唯一且稳定的 key。
key 不是显示内容,也不会自动传入子组件。组件内部若需要 ID,仍应显式传递 id 属性。
items.map((item) => (
<TaskRow key={item.id} id={item.id} name={item.name} />
))这段代码是片段示例,依赖已经定义的 items 数组和 TaskRow 组件。生效后,React 会使用 item.id 识别每个同级列表项。
Key 如何影响组件复用
当列表顺序变化时,React 会比较更新前后的同级元素。稳定 key 能让旧组件与同一条业务数据重新对应;索引 key 只代表当前位置,位置变化后可能把旧组件状态错误地交给另一条数据。

完整示例
下面的组件可直接替换 Vite React 项目中的 src/App.jsx。先在任意输入框中修改文字,再反转顺序,并切换两种 key 策略观察差异。
import { useState } from 'react';
function TaskRow({ task }) {
const [draft, setDraft] = useState(task.name);
return (
<li>
<span>{task.id}:</span>
<input
value={draft}
onChange={(event) => setDraft(event.target.value)}
/>
</li>
);
}
export default function App() {
const [tasks, setTasks] = useState([
{ id: 'T-101', name: '检查接口' },
{ id: 'T-102', name: '编写测试' },
{ id: 'T-103', name: '发布版本' },
]);
const [useIndexKey, setUseIndexKey] = useState(false);
function reverseTasks() {
// 创建新数组,避免直接修改原状态。
setTasks((current) => [...current].reverse());
}
return (
<main>
<h1>任务列表</h1>
<p>当前策略:{useIndexKey ? '数组索引' : '稳定 ID'}</p>
<button onClick={reverseTasks}>反转顺序</button>
<button onClick={() => setUseIndexKey((value) => !value)}>
切换 Key 策略
</button>
<ul>
{tasks.map((task, index) => (
<TaskRow
key={useIndexKey ? index : task.id}
task={task}
/>
))}
</ul>
</main>
);
}预期结果
使用稳定 ID 时,修改某一行输入框后再反转列表,输入状态会跟随同一个任务移动。
切换为数组索引后,修改第一行再反转列表,输入状态可能仍停留在第一行位置,却对应了另一条任务数据。选择 Key 的规则
首选数据库主键、业务编号或创建数据时生成的稳定 ID。一个好的 key 应同时满足三个条件:在同级列表中唯一、在多次渲染之间稳定、能够代表同一条业务数据。
不要在渲染时调用 Math.random() 生成 key。每次渲染都会得到新值,React 会把所有旧组件视为已删除,再重新挂载新组件,导致输入状态丢失并增加更新成本。
数组索引只适合不会增删、不会排序、不会筛选,且列表项没有独立状态的静态列表。只要未来可能发生结构变化,就应尽早使用稳定 ID。
常见边界
key 只要求在当前兄弟节点之间唯一,不要求整个应用全局唯一。两个不同列表都可以包含 key="T-101",因为它们不在同一组兄弟元素中。
把 key 放到子组件内部通常无效。React 在创建列表元素的那一层就需要读取它,因此应写在 map() 直接返回的元素上。