React / 系统课时
列表渲染与 key
列表渲染与 key
当界面要展示一组同类数据时,React 通常用 map() 把数组转换为一组 JSX。真正容易出错的不是“循环怎么写”,而是怎样给每个列表项提供稳定身份,让插入、删除和重排时的更新保持正确。
学习目标
- 使用
map()将数据数组渲染为 JSX 列表 - 理解
key如何帮助 React 匹配更新前后的列表项 - 能选择稳定的
key,并避开索引和随机值等常见误用
用 map 生成列表元素
列表渲染的核心是“数据驱动界面”:先准备数组,再把每一项映射成 JSX。map() 返回的新数组可以直接放进 JSX 中,React 会依次渲染这些元素。
下面的示例可放入已有 React 项目的 src/main.jsx。它支持在列表头部添加任务,也支持删除任务;每个任务都带有不会随位置变化的 id,因此即使顺序改变,React 仍能识别同一个任务。
import React, { useState } from "react";
import { createRoot } from "react-dom/client";
function App() {
const [tasks, setTasks] = useState([
{ id: "t1", title: "学习 JSX" },
{ id: "t2", title: "练习列表渲染" }
]);
function addTask() {
const task = { id: "t3", title: "理解 key" };
setTasks(current => [task, ...current]);
}
function removeTask(id) {
setTasks(current => current.filter(task => task.id !== id));
}
return (
<main>
<button onClick={addTask}>在顶部添加任务</button>
<ul>
{tasks.map(task => (
<li key={task.id}>
{task.title}
<button onClick={() => removeTask(task.id)}>删除</button>
</li>
))}
</ul>
</main>
);
}
createRoot(document.getElementById("root")).render(<App />);预期结果
初始列表:学习 JSX、练习列表渲染
点击“在顶部添加任务”:理解 key 出现在最上方
点击某项“删除”:只移除对应任务key 是列表项的稳定身份
key 不负责显示内容,它只用于帮助 React 在同一层级的兄弟元素之间判断“哪个旧元素对应哪个新元素”。当数组发生插入、删除或重排时,稳定的 key 能让 React 尽量复用正确的组件实例和 DOM 节点。

可以把 key 理解成列表项在当前兄弟集合里的“身份证”。只要同一条业务数据继续存在,它的 key 就应该保持不变。
选择正确的 key
优先使用数据本身已经存在且唯一、稳定的标识,例如数据库主键、订单号或业务 ID。理想的 key 同时满足两个条件:在当前列表中唯一,并且同一条数据在多次渲染之间保持不变。
数组索引只适合列表永远不会插入、删除或重排的极少数场景。如果使用索引作为 key,在顶部插入一项后,原来每个元素的索引都会变化,组件内部状态就可能跟错对象。
同样不要在渲染时使用 Math.random() 生成 key。随机值每次渲染都会变化,React 会把元素视为全新的节点,导致不必要的卸载和重新创建。
判断列表更新是否安全
看到列表代码时,可以依次检查三个问题:数据是否通过 map() 转成 JSX;每个直接返回的同层元素是否有 key;这个 key 是否来自稳定业务标识而不是当前位置。
只要列表可能发生增删或排序,就把“稳定身份”当成设计数据结构的一部分。这样不仅能消除 React 的 key 警告,也能避免输入框状态、组件状态或 DOM 复用落到错误的列表项上。