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