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 读取,所以切换主题不会触发这次同步。

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

预期输出

text
首次挂载:sync title: general
点击“切换房间”:sync title: support
点击“切换主题”:不会因为 theme 改变而新增这条 Effect 日志

开发环境若启用 Strict Mode,首次挂载的 Effect 日志可能出现额外一次,这是 React 的开发期检查行为;判断依赖是否正确时,应关注“某个依赖变化后是否按预期重新同步”。

不要为了控制次数而删除依赖

依赖数组不是手工调度器。只要 Effect 的代码读取了某个响应式值,这个值原则上就应该成为依赖。若静态检查工具提示缺少依赖,优先修改 Effect 的结构,而不是删除依赖来“让它少执行几次”。

常见问题是每次渲染都会重新创建对象或函数,例如 const options = { roomId }。如果把 options 直接放进依赖数组,它的引用每次都不同,Effect 就可能频繁重跑。更直接的做法通常是把对象创建移进 Effect,只依赖真正变化的原始值;只有确实需要稳定引用时,再考虑 useMemo 或 useCallback。

依赖正确比执行次数少更重要

一个正确的依赖数组描述的是“这次同步使用了哪些响应式输入”。先保证依赖完整,再通过拆分 Effect、移动对象创建位置或调整组件结构减少不必要执行。把依赖删掉虽然可能暂时减少日志,却会让 Effect 与界面状态失去同步,问题通常更难排查。

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

目录与阅读设置

阅读设置

17

记录一个想法

依赖数组

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

登录哪都通