React / 系统课时
依赖数组
依赖数组
依赖数组决定一个 Effect 何时需要用新的 props、state 或局部值重新同步外部系统。真正的难点不是“填几个变量”,而是让数组准确描述 Effect 读取的响应式值,从而避免旧值、漏同步和无意义的重复执行。
学习目标
- 区分省略依赖数组、空数组和指定依赖三种行为
- 能根据 Effect 中读取的响应式值列出完整依赖
- 能处理函数、对象等导致依赖频繁变化的常见情况
三种依赖写法
useEffect 的第二个参数有三种常见形态。React 会用 Object.is 比较新旧依赖值,只要指定依赖中有任意一个发生变化,就会先清理旧 Effect,再执行新的 Effect。
| 写法 | 执行行为 | 适用情况 |
|---|---|---|
| 不传第二个参数 | 每次提交后都执行 | Effect 确实需要跟随每次渲染同步 |
[] |
挂载后执行,卸载时清理 | Effect 不读取会变化的响应式值 |
[a, b] |
挂载后执行,且 a 或 b 变化时重新执行 |
Effect 依赖明确的 props、state 或局部值 |
空数组不是“忽略依赖”的开关。如果 Effect 内读取了会变化的 props 或 state,却仍写成 [],Effect 会一直使用初次渲染时捕获的值,形成闭包中的旧数据问题。
让依赖与读取值保持一致
下面的示例把当前房间名同步到浏览器标题。Effect 内读取了 roomId,因此依赖数组中必须包含 roomId;theme 没有被 Effect 读取,所以切换主题不会触发这次同步。
import { useEffect, useState } from 'react';
export default function App() {
const [roomId, setRoomId] = useState('general');
const [theme, setTheme] = useState('light');
useEffect(() => {
// 这里只读取 roomId,因此依赖也只需要 roomId。
document.title = `Room: ${roomId}`;
console.log(`sync title: ${roomId}`);
}, [roomId]);
return (
<div>
<p>当前房间:{roomId}</p>
<p>当前主题:{theme}</p>
<button onClick={() => setRoomId('support')}>切换房间</button>
<button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
切换主题
</button>
</div>
);
}预期输出
首次挂载:sync title: general
点击“切换房间”:sync title: support
点击“切换主题”:不会因为 theme 改变而新增这条 Effect 日志开发环境若启用 Strict Mode,首次挂载的 Effect 日志可能出现额外一次,这是 React 的开发期检查行为;判断依赖是否正确时,应关注“某个依赖变化后是否按预期重新同步”。
不要为了控制次数而删除依赖
依赖数组不是手工调度器。只要 Effect 的代码读取了某个响应式值,这个值原则上就应该成为依赖。若静态检查工具提示缺少依赖,优先修改 Effect 的结构,而不是删除依赖来“让它少执行几次”。
常见问题是每次渲染都会重新创建对象或函数,例如 const options = { roomId }。如果把 options 直接放进依赖数组,它的引用每次都不同,Effect 就可能频繁重跑。更直接的做法通常是把对象创建移进 Effect,只依赖真正变化的原始值;只有确实需要稳定引用时,再考虑 useMemo 或 useCallback。
依赖正确比执行次数少更重要
一个正确的依赖数组描述的是“这次同步使用了哪些响应式输入”。先保证依赖完整,再通过拆分 Effect、移动对象创建位置或调整组件结构减少不必要执行。把依赖删掉虽然可能暂时减少日志,却会让 Effect 与界面状态失去同步,问题通常更难排查。