差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| react:useeffect [2026/10/14 10:02] – 创建 张叶安 | react:useeffect [2026/10/14 10:04] (当前版本) – 为 react:useeffect 添加思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== useEffect ====== |
| + | |||
| + | '' | ||
| + | |||
| + | 一句话概括:**渲染负责「算出界面长什么样」,'' | ||
| + | |||
| + | ===== 一句话理解 ===== | ||
| + | |||
| + | <code javascript> | ||
| + | import { useState, useEffect } from ' | ||
| + | |||
| + | function Counter() { | ||
| + | const [count, setCount] = useState(0); | ||
| + | |||
| + | // 每次 count 变化后,把页面标题同步为最新值 | ||
| + | useEffect(() => { | ||
| + | document.title = `点击了 ${count} 次`; | ||
| + | }, [count]); | ||
| + | |||
| + | return <button onClick={() => setCount(count + 1)}> | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | '' | ||
| + | |||
| + | ===== 什么是副作用 ===== | ||
| + | |||
| + | **渲染应该是纯的**:同样的 props 和 state,就应该渲染出同样的 JSX,过程中不去碰外部世界。 | ||
| + | |||
| + | 但真实应用必须和外部世界打交道: | ||
| + | |||
| + | | 要做的事 | 涉及的外部对象 | | ||
| + | | 获取数据 | 服务器接口 | | ||
| + | | 监听窗口大小、键盘、滚动 | 浏览器事件 | | ||
| + | | 聚焦输入框、初始化地图/ | ||
| + | | 定时刷新 | 定时器 API | | ||
| + | | 写 localStorage、改页面标题 | 浏览器存储 / document | | ||
| + | |||
| + | 这些「不参与计算界面、发生在渲染之外」的动作统称为**副作用**,'' | ||
| + | |||
| + | ===== 基本语法 ===== | ||
| + | |||
| + | <code javascript> | ||
| + | useEffect(() => { | ||
| + | // 副作用代码:DOM 更新完成之后执行 | ||
| + | |||
| + | return () => { | ||
| + | // 清理函数(可选):卸载前、下次执行前调用 | ||
| + | }; | ||
| + | }, [依赖项]); | ||
| + | </ | ||
| + | |||
| + | * **第一个参数**:effect 函数,React 保证在 **DOM 更新之后**才调用它。 | ||
| + | * **第二个参数**:**依赖数组**,决定什么时候重新执行这个 effect。 | ||
| + | * **返回值**(可选):**清理函数**,用来撤销上一次的副作用。 | ||
| + | |||
| + | 和 '' | ||
| + | |||
| + | ===== 执行时机 ===== | ||
| + | |||
| + | * 组件渲染 → React 把结果**提交到 DOM**(浏览器可能已经绘制)→ 再执行 effect。 | ||
| + | * 因此 effect **不会阻塞页面绘制**,不适合放「用户必须立刻看到」的同步逻辑。 | ||
| + | * **首次挂载一定会执行一次**,不管依赖数组怎么写。 | ||
| + | * 依赖变化时:先执行**上一次的清理函数**,再执行新的 effect。 | ||
| + | * 组件卸载时:执行最后一次的清理函数。 | ||
| + | |||
| + | ===== 依赖数组:控制何时重新执行 ===== | ||
| + | |||
| + | | 写法 | 执行时机 | 适用场景 | | ||
| + | | 不传第二个参数 | 每次渲染后都执行 | 很少用,容易出问题 | | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 1. 不传依赖:每次渲染后都执行(通常不是你想要的) | ||
| + | useEffect(() => { | ||
| + | console.log(' | ||
| + | }); | ||
| + | |||
| + | // 2. 空数组:只在挂载后执行一次 | ||
| + | useEffect(() => { | ||
| + | console.log(' | ||
| + | }, []); | ||
| + | |||
| + | // 3. 指定依赖:count 或 userId 变化时重新执行 | ||
| + | useEffect(() => { | ||
| + | fetchUser(userId, | ||
| + | }, [userId, count]); | ||
| + | </ | ||
| + | |||
| + | 依赖项之间用 '' | ||
| + | |||
| + | ===== 清理函数 ===== | ||
| + | |||
| + | 返回一个函数就是清理函数,它会在两个时机被调用: | ||
| + | |||
| + | * **组件卸载前** | ||
| + | * **依赖变化、下一次 effect 执行之前** | ||
| + | |||
| + | 作用是「把上一个副作用收干净」,避免内存泄漏、重复订阅、以及旧请求覆盖新结果。 | ||
| + | |||
| + | <code javascript> | ||
| + | // 订阅事件:卸载时必须退订 | ||
| + | useEffect(() => { | ||
| + | const onResize = () => setWidth(window.innerWidth); | ||
| + | window.addEventListener(' | ||
| + | |||
| + | return () => window.removeEventListener(' | ||
| + | }, []); | ||
| + | |||
| + | // 定时器:卸载时必须清除 | ||
| + | useEffect(() => { | ||
| + | const id = setInterval(() => setTick(t => t + 1), 1000); | ||
| + | return () => clearInterval(id); | ||
| + | }, []); | ||
| + | |||
| + | // 请求:取消旧请求,避免竞态 | ||
| + | useEffect(() => { | ||
| + | const controller = new AbortController(); | ||
| + | |||
| + | fetch(`/ | ||
| + | .then(res => res.json()) | ||
| + | .then(setUser) | ||
| + | .catch(err => { | ||
| + | if (err.name !== ' | ||
| + | }); | ||
| + | |||
| + | return () => controller.abort(); | ||
| + | }, [userId]); | ||
| + | </ | ||
| + | |||
| + | 原则:**任何「申请了资源」的 effect 都应有对应的清理**——订阅要退订、定时器要清除、请求要取消、第三方实例要销毁。 | ||
| + | |||
| + | ===== 常见使用场景 ===== | ||
| + | |||
| + | ==== 1. 请求数据 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | const [data, setData] = useState(null); | ||
| + | const [loading, setLoading] = useState(true); | ||
| + | |||
| + | useEffect(() => { | ||
| + | let ignore = false; | ||
| + | |||
| + | setLoading(true); | ||
| + | fetch(`/ | ||
| + | .then(res => res.json()) | ||
| + | .then(json => { | ||
| + | if (!ignore) { | ||
| + | setData(json); | ||
| + | setLoading(false); | ||
| + | } | ||
| + | }); | ||
| + | |||
| + | return () => { | ||
| + | ignore = true; // 丢弃已经过期的响应 | ||
| + | }; | ||
| + | }, [id]); | ||
| + | </ | ||
| + | |||
| + | 注意:**effect 本身不能是 '' | ||
| + | |||
| + | ==== 2. 订阅外部数据源 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | useEffect(() => { | ||
| + | const unsubscribe = store.subscribe(() => { | ||
| + | setSnapshot(store.getSnapshot()); | ||
| + | }); | ||
| + | return unsubscribe; | ||
| + | }, []); | ||
| + | </ | ||
| + | |||
| + | ==== 3. 操作 DOM ==== | ||
| + | |||
| + | <code javascript> | ||
| + | const inputRef = useRef(null); | ||
| + | |||
| + | useEffect(() => { | ||
| + | inputRef.current.focus(); | ||
| + | }, []); | ||
| + | </ | ||
| + | |||
| + | 初始化地图、图表、视频播放器等第三方库也属于这一类,都需要在清理函数里销毁实例。 | ||
| + | |||
| + | ==== 4. 同步到浏览器 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | useEffect(() => { | ||
| + | document.title = title; | ||
| + | }, [title]); | ||
| + | |||
| + | useEffect(() => { | ||
| + | localStorage.setItem(' | ||
| + | }, [theme]); | ||
| + | </ | ||
| + | |||
| + | ===== 常见坑 ===== | ||
| + | |||
| + | **无限循环**:effect 里调用 '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 错误 | ||
| + | useEffect(() => { | ||
| + | setCount(count + 1); | ||
| + | }, [count]); | ||
| + | |||
| + | // 正确:用函数式更新,就不必把 count 放进依赖 | ||
| + | useEffect(() => { | ||
| + | setCount(prev => prev + 1); | ||
| + | }, []); | ||
| + | </ | ||
| + | |||
| + | **依赖里放了每次都是新引用的对象/ | ||
| + | |||
| + | **遗漏依赖(闭包旧值)**:effect 只依赖 '' | ||
| + | |||
| + | **把 '' | ||
| + | |||
| + | **清理不彻底**:只 '' | ||
| + | |||
| + | **用 effect 做渲染时就能算出的事**:例如「根据 firstName 和 lastName 得出 fullName」,直接在渲染时算即可,不需要额外的 state 和 effect。 | ||
| + | |||
| + | **StrictMode 下开发环境执行两次**:React 18+ 在开发模式会「挂载 → 卸载 → 再挂载」,用来暴露清理不彻底的 bug。这是刻意行为;写法正确时不受影响,生产构建只执行一次。 | ||
| + | |||
| + | ===== 什么时候不需要 useEffect ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | | 需求 | 更好的做法 | | ||
| + | | 能由现有 props / state 算出 | 直接在渲染中计算 | | ||
| + | | 用户点击后要做的事 | 写在事件处理函数里 | | ||
| + | | 某个 prop 变化时要重置内部 state | 给组件加 '' | ||
| + | | 缓存父组件传来的计算结果 | 放到父组件的 '' | ||
| + | | 读取最新值但不触发渲染 | '' | ||
| + | |||
| + | ===== 与其他 Hook 的关系 ===== | ||
| + | |||
| + | | Hook | 作用 | | ||
| + | | useState | 组件内部状态,驱动重新渲染 | | ||
| + | | useRef | 存不触发渲染的值(DOM 引用、定时器 id) | | ||
| + | | useEffect | 渲染后与外部系统同步,可清理 | | ||
| + | | useLayoutEffect | 同上,但在浏览器绘制**之前**同步执行 | | ||
| + | | useMemo / useCallback | 稳定对象、函数引用,减少多余的 effect | | ||
| + | | useContext | 跨层级读取共享数据,常与 effect 配合使用 | | ||
| + | |||
| + | ===== 小结 ===== | ||
| + | |||
| + | * '' | ||
| + | * 它在**渲染提交到 DOM 之后**执行,不阻塞绘制,首次挂载必然执行一次。 | ||
| + | * **依赖数组决定重跑时机**:不传 = 每次渲染;'' | ||
| + | * 依赖是 '' | ||
| + | * **有副作用的申请,就要有清理函数**:退订、清定时器、取消请求。 | ||
| + | * 不要在 effect 里做能用渲染计算或事件处理完成的事,避免滥用。 | ||
| + | |||
| + | ===== 相关页面 ===== | ||
| + | |||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | |||
| + | ```mdk height=480 color=# | ||
| + | # useEffect | ||
| + | |||
| + | ## 是什么 | ||
| + | - React 内置 Hook | ||
| + | - 用来执行「副作用」 | ||
| + | - 把组件与外部系统同步 | ||
| + | - 渲染后执行,不阻塞绘制 | ||
| + | |||
| + | ## 什么是副作用 | ||
| + | - 请求数据 → 服务器接口 | ||
| + | - 订阅事件 → 浏览器事件 | ||
| + | - 操作 DOM → 聚焦、滚动、第三方库 | ||
| + | - 定时器 / localStorage / 页面标题 | ||
| + | - 渲染应保持纯净,副作用另安放 | ||
| + | |||
| + | ## 基本语法 | ||
| + | - `useEffect(effect, | ||
| + | - effect:DOM 更新后调用 | ||
| + | - 返回值:清理函数(可选) | ||
| + | - 必须在组件顶层调用 | ||
| + | |||
| + | ## 依赖数组 | ||
| + | - 不传 → 每次渲染都执行 | ||
| + | - `[]` → 只在挂载后执行一次 | ||
| + | - `[a, b]` → 挂载后 + a / b 变化时 | ||
| + | - Object.is 浅比较 | ||
| + | - 对象 / 函数需保持引用稳定 | ||
| + | |||
| + | ## 执行时机 | ||
| + | - 渲染 → 提交 DOM → 执行 effect | ||
| + | - 首次挂载必执行一次 | ||
| + | - 不阻塞浏览器绘制 | ||
| + | - useLayoutEffect:绘制前同步执行 | ||
| + | |||
| + | ## 清理函数 | ||
| + | - 组件卸载前调用 | ||
| + | - 下次 effect 执行前调用 | ||
| + | - 退订事件、清除定时器 | ||
| + | - 取消请求(AbortController) | ||
| + | - 有申请就应有清理 | ||
| + | |||
| + | ## 常见场景 | ||
| + | - 获取数据(防竞态) | ||
| + | - 订阅外部 store | ||
| + | - 聚焦、初始化第三方库 | ||
| + | - 同步 document.title / localStorage | ||
| + | |||
| + | ## 常见坑 | ||
| + | - 依赖不全 → 闭包读到旧值 | ||
| + | - 依赖里放新引用对象 → 每次执行 | ||
| + | - effect 里 setState 又依赖该 state → 无限循环 | ||
| + | - 直接把 async 函数传给 useEffect | ||
| + | - 只订阅不取消 → 内存泄漏 | ||
| + | - 用 effect 做渲染时就能算的事 | ||
| + | - StrictMode 开发环境执行两次 | ||
| + | |||
| + | ## 不该用 useEffect | ||
| + | - 能由 props / state 算出 → 渲染时算 | ||
| + | - 用户操作触发 → 事件处理函数 | ||
| + | - 重置组件状态 → 用 key | ||
| + | - 读最新值但不渲染 → useRef | ||
| + | |||
| + | ## 相关 Hook | ||
| + | - useState:状态与重渲染 | ||
| + | - useRef:不触发渲染的值 | ||
| + | - useMemo / useCallback:稳定引用 | ||
| + | - useContext:跨层级共享数据 | ||
| + | ``` | ||