React / 系统课时

对象与数组状态更新

对象与数组状态更新

本课通过一个可运行的任务列表组件,演示如何更新对象字段、切换数组元素、追加和删除数据。你将看到为什么 React 状态不能直接修改,以及如何用展开语法、map、filter 和函数式更新稳定地产生新状态。

学习目标

  • 使用展开语法更新对象,并保留未变化字段
  • 使用 map、filter 和数组展开语法完成增删改
  • 理解不可变更新、引用变化和函数式更新的关系

为什么不能直接修改状态

React 状态应当视为只读快照。直接执行 profile.city = "Penang" 或 tasks.push(newTask) 只修改了原对象,引用没有变化,React 可能无法按预期判断状态已经更新,也会让旧状态、调试记录和派生计算受到污染。

正确做法是创建新对象或新数组,再交给状态更新函数。若新状态依赖旧状态,应使用 setState(previous => next),这样连续更新时总能基于 React 提供的最新快照计算。

完整实现一个任务列表

下面的 App.jsx 同时覆盖对象字段更新、数组追加、元素切换和删除。代码可以直接放入 Vite React 项目运行。

jsx
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>
  );
}

预期结果:

text
初始显示 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 列表和对象映射,但简单页面无需过度设计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

对象与数组状态更新

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通