React / 系统课时
对象与数组状态更新
对象与数组状态更新
本课通过一个可运行的任务列表组件,演示如何更新对象字段、切换数组元素、追加和删除数据。你将看到为什么 React 状态不能直接修改,以及如何用展开语法、map、filter 和函数式更新稳定地产生新状态。
学习目标
- 使用展开语法更新对象,并保留未变化字段
- 使用
map、filter和数组展开语法完成增删改 - 理解不可变更新、引用变化和函数式更新的关系
为什么不能直接修改状态
React 状态应当视为只读快照。直接执行 profile.city = "Penang" 或 tasks.push(newTask) 只修改了原对象,引用没有变化,React 可能无法按预期判断状态已经更新,也会让旧状态、调试记录和派生计算受到污染。
正确做法是创建新对象或新数组,再交给状态更新函数。若新状态依赖旧状态,应使用 setState(previous => next),这样连续更新时总能基于 React 提供的最新快照计算。
完整实现一个任务列表
下面的 App.jsx 同时覆盖对象字段更新、数组追加、元素切换和删除。代码可以直接放入 Vite React 项目运行。
import { useRef, useState } from "react";
export default function App() {
const [profile, setProfile] = useState({
name: "Ada",
city: "Kuala Lumpur",
});
const [tasks, setTasks] = useState([
{ id: 1, title: "阅读 React 文档", done: false },
{ id: 2, title: "完成状态练习", done: true },
]);
const nextTaskId = useRef(3);
function handleCityChange(event) {
const city = event.currentTarget.value;
// 复制旧对象后只覆盖 city,保留 name 等字段
setProfile((previous) => ({
...previous,
city,
}));
}
function addTask() {
const id = nextTaskId.current;
nextTaskId.current += 1;
// 返回新数组,不调用 push 修改原数组
setTasks((previous) => [
...previous,
{ id, title: `新任务 ${id}`, done: false },
]);
}
function toggleTask(id) {
// map 只替换命中的任务对象
setTasks((previous) =>
previous.map((task) =>
task.id === id ? { ...task, done: !task.done } : task
)
);
}
function removeTask(id) {
// filter 返回不包含目标任务的新数组
setTasks((previous) =>
previous.filter((task) => task.id !== id)
);
}
return (
<main>
<h1>{profile.name} 的任务</h1>
<label>
城市:
<input value={profile.city} onChange={handleCityChange} />
</label>
<p>当前城市:{profile.city}</p>
<button type="button" onClick={addTask}>
添加任务
</button>
<ul>
{tasks.map((task) => (
<li key={task.id}>
<button type="button" onClick={() => toggleTask(task.id)}>
{task.done ? "已完成" : "未完成"}
</button>
<span>{task.title}</span>
<button type="button" onClick={() => removeTask(task.id)}>
删除
</button>
</li>
))}
</ul>
</main>
);
}预期结果:
初始显示 Ada、Kuala Lumpur 和两条任务
修改城市输入框:当前城市文本同步变化,name 字段保持不变
点击“添加任务”:列表末尾增加“新任务 3”
点击任务状态按钮:该任务在“未完成”和“已完成”之间切换
点击“删除”:只移除对应 id 的任务对象状态:复制后覆盖字段
{ ...previous, city } 会先复制旧对象的全部字段,再用新的 city 覆盖同名字段。覆盖顺序很重要:新字段应写在展开结果之后,否则旧值会把新值覆盖。
当对象包含嵌套对象时,每一层被修改的对象都要复制。例如修改 profile.address.city 时,需要同时创建新的 profile 和新的 address,不能只复制最外层后继续修改内部旧对象。
数组状态:按操作选择方法
| 更新目标 | 推荐写法 | 结果 |
|---|---|---|
| 追加元素 | [...previous, newItem] |
创建包含旧元素和新元素的新数组 |
| 修改元素 | previous.map(...) |
目标元素返回新对象,其余元素原样返回 |
| 删除元素 | previous.filter(...) |
创建不包含目标元素的新数组 |
| 替换全部 | setTasks(newTasks) |
使用已经准备好的新数组 |
map 更新时,只需要复制真正变化的元素。示例中的其他任务直接返回原对象,可以减少无意义的新对象创建,同时保持代码清晰。
列表渲染必须使用稳定且唯一的 key。不要在可增删或可排序的列表中使用数组下标,否则元素位置变化后,React 可能错误复用已有界面状态。
更新边界与调试方法
不要调用会原地修改数组的方法后再传回同一数组,例如 push、splice、sort 和 reverse。确实需要排序时,可以先复制:const sorted = [...previous].sort(compareFn),再返回 sorted。
调试时可以在更新前后比较引用。对象或数组完成不可变更新后,应满足“内容按预期变化,顶层引用不同”;未变化的嵌套数据则可以继续复用旧引用。
状态结构也应尽量扁平。嵌套层级过深会增加复制成本和遗漏风险;若数据天然按 id 更新,可以考虑把数组拆成 id 列表和对象映射,但简单页面无需过度设计。