React / 知识点

React Hooks 速查手册

手册条目

检查对象引用、原地修改和相同值更新导致的界面未变化问题。

排查无效状态更新

用于处理“已经调用状态更新函数,但界面没有变化”或“下一次操作时数值突然跳变”。优先检查新旧值是否被 Object.is 判定为相同,以及对象、数组或嵌套字段是否被原地修改。

快速定位

最常见的信号是:事件处理函数确实执行,日志里的对象字段也已变化,但当前画面不刷新。此时不要先怀疑异步渲染,先保存更新前后的值并检查引用。

  • Object.is(prev, next) === true:React 可能跳过这次更新;对象通常是复用了原引用。
  • 浅拷贝了外层对象,但继续修改内部对象:嵌套引用仍然相同,旧状态也被污染。
  • 对数组使用 push、splice、sort 或直接改下标:数组或元素对象可能仍是旧引用。
  • setState(currentValue):原始值未改变,更新被合并或跳过属于正常行为。

主示例

下面的两个按钮分别演示原地修改和创建新对象。代码可直接放入 React TypeScript 项目的 App.tsx。

tsx
import { useState } from 'react';

type Profile = {
  name: string;
  score: number;
};

export default function App() {
  const [profile, setProfile] = useState<Profile>({
    name: 'Ada',
    score: 0,
  });

  function mutateWrong() {
    const before = profile;
    profile.score += 1; // 原地修改,profile 仍是同一个对象
    console.log('same reference:', Object.is(before, profile));
    setProfile(profile);
  }

  function updateRight() {
    const next = {
      ...profile,
      score: profile.score + 1,
    };
    console.log('same reference:', Object.is(profile, next));
    setProfile(next);
  }

  return (
    <main>
      <p>{profile.name}: {profile.score}</p>
      <button onClick={mutateWrong}>错误更新</button>
      <button onClick={updateRight}>正确更新</button>
    </main>
  );
}

预期结果

text
初始页面:Ada: 0
点击“错误更新”:页面仍显示 Ada: 0
控制台:same reference: true
随后点击“正确更新”:页面显示 Ada: 2
控制台:same reference: false

数值从 0 跳到 2,说明第一次原地修改已污染内存中的旧状态,只是相同引用没有触发可见更新。

高频修复

对象字段更新时返回新对象;嵌套对象要从被修改节点一路复制到顶层。下面是片段示例,假设当前组件已定义包含 address.city 的 profile 状态。

tsx
setProfile(current => ({
  ...current,
  address: {
    ...current.address,
    city: 'Shenzhen',
  },
}));

预期结果

text
profile 与旧对象引用不同,address 与旧嵌套对象引用也不同;依赖这些值的界面会按新状态重新计算。

数组更新优先使用 map、filter、展开语法或先复制再排序。更新数组中的对象时,既要返回新数组,也要替换目标元素对象。

风险与边界

仅复制最外层但修改深层字段,会同时污染历史状态和其他共享引用,后果可能是界面延迟跳变、撤销失效或组件之间相互影响。安全做法是逐层复制,或者在深层状态复杂时使用 reducer、扁平化数据结构或 Immer。

不要用无关状态、随机数或 forceUpdate 强制刷新来掩盖引用错误。这会让画面暂时变化,但被污染的数据仍存在,后续 memo、Effect 依赖和缓存判断会继续异常。

排障清单

  1. 确认事件处理函数确实执行,且更新函数没有被条件分支提前跳过。
  2. 对更新前后值执行 Object.is(prev, next);对象或数组应在内容变化时得到新引用。
  3. 搜索 push、splice、sort、reverse、属性赋值和下标赋值,检查它们是否直接作用于 state。
  4. 检查浅拷贝后的嵌套字段,确保从修改点到顶层的每一级都已复制。
  5. 若值本来就相同,不要期待重新渲染;把需要重新执行的副作用放在明确事件或外部同步逻辑中。

目录与阅读设置

记录一个想法

React Hooks 速查手册

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

登录哪都通