差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| react:usecallback [2026/10/16 09:38] – 创建 张叶安 | react:usecallback [2026/10/16 09:40] (当前版本) – 添加 useCallback 思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== useCallback ====== |
| + | |||
| + | '' | ||
| + | |||
| + | 一句话概括:'' | ||
| + | |||
| + | 注意:它**不是用来让函数跑得更快的**。函数本身的执行速度不会因为 '' | ||
| + | |||
| + | ===== 为什么需要它 ===== | ||
| + | |||
| + | React 函数组件**每次渲染都会重新执行整个函数体**,因此组件里写的每个函数**每次渲染都是全新的对象**: | ||
| + | |||
| + | <code javascript> | ||
| + | function Parent() { | ||
| + | const [count, setCount] = useState(0); | ||
| + | |||
| + | // 每次 Parent 渲染,这个函数都是新创建的 | ||
| + | const handleClick = () => { | ||
| + | console.log(' | ||
| + | } | ||
| + | |||
| + | return <Child onClick={handleClick} />; | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 问题的关键在于 **JS 里函数是引用类型**:'' | ||
| + | |||
| + | | 引用变化带来的后果 | 说明 | | ||
| + | | 传给 '' | ||
| + | | 作为 '' | ||
| + | | 作为 '' | ||
| + | |||
| + | '' | ||
| + | |||
| + | ===== 基本语法 ===== | ||
| + | |||
| + | <code javascript> | ||
| + | const memoizedFn = useCallback(() => { | ||
| + | // 函数体 | ||
| + | }, [依赖项]); | ||
| + | </ | ||
| + | |||
| + | * **第一个参数**:你要缓存的函数 | ||
| + | * **第二个参数**:**依赖数组**,数组里任一项变化时才会创建新的函数;传 '' | ||
| + | * **返回值**:当前这次渲染应该使用的函数 | ||
| + | |||
| + | 和 '' | ||
| + | |||
| + | ===== 一句话理解 ===== | ||
| + | |||
| + | <code javascript> | ||
| + | import { useState, useCallback, | ||
| + | |||
| + | const Child = memo(function Child({ onAdd }) { | ||
| + | console.log(' | ||
| + | return <button onClick={onAdd}> | ||
| + | }); | ||
| + | |||
| + | function Parent() { | ||
| + | const [count, setCount] = useState(0); | ||
| + | const [text, setText] = useState('' | ||
| + | |||
| + | // 依赖为 [],handleAdd 永远是同一个引用 | ||
| + | const handleAdd = useCallback(() => { | ||
| + | setCount(prev => prev + 1); | ||
| + | }, []); | ||
| + | |||
| + | return ( | ||
| + | < | ||
| + | <input value={text} onChange={e => setText(e.target.value)} /> | ||
| + | <Child onAdd={handleAdd} /> | ||
| + | </ | ||
| + | ); | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 在输入框里打字时,'' | ||
| + | |||
| + | ===== 依赖数组 ===== | ||
| + | |||
| + | | 写法 | 行为 | 适用场景 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | 不传 | 等于没有缓存,每次都是新函数 | 没有意义,别这么写 | | ||
| + | |||
| + | <code javascript> | ||
| + | // 函数里用到了 id,就必须把 id 放进依赖 | ||
| + | const load = useCallback(() => { | ||
| + | fetch(`/ | ||
| + | }, [id]); | ||
| + | |||
| + | // 用到了父组件传来的 onSave,也要写进依赖 | ||
| + | const handleSave = useCallback(() => { | ||
| + | onSave(formData); | ||
| + | }, [onSave, formData]); | ||
| + | </ | ||
| + | |||
| + | **依赖数组里的值和 '' | ||
| + | |||
| + | ===== 用函数式更新减少依赖 ===== | ||
| + | |||
| + | 这是让 '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 依赖里有 count:count 一变,函数就要重建 | ||
| + | const handleAdd = useCallback(() => { | ||
| + | setCount(count + 1); | ||
| + | }, [count]); | ||
| + | |||
| + | // 用 prev 取值:依赖为空,函数永远稳定 | ||
| + | const handleAdd = useCallback(() => { | ||
| + | setCount(prev => prev + 1); | ||
| + | }, []); | ||
| + | </ | ||
| + | |||
| + | 同理,能从 '' | ||
| + | |||
| + | ===== 常见使用场景 ===== | ||
| + | |||
| + | ==== 1. 配合 React.memo 的子组件 ==== | ||
| + | |||
| + | 这是 '' | ||
| + | |||
| + | <code javascript> | ||
| + | const List = memo(function List({ items, onSelect }) { | ||
| + | return items.map(item => ( | ||
| + | <button key={item.id} onClick={() => onSelect(item.id)}> | ||
| + | {item.name} | ||
| + | </ | ||
| + | )); | ||
| + | }); | ||
| + | |||
| + | function App() { | ||
| + | const [items, setItems] = useState([]); | ||
| + | const [keyword, setKeyword] = useState('' | ||
| + | |||
| + | // 不用 useCallback:App 每次渲染 List 都会重渲染 | ||
| + | const handleSelect = useCallback(id => { | ||
| + | console.log(' | ||
| + | }, []); | ||
| + | |||
| + | return ( | ||
| + | <> | ||
| + | <input value={keyword} onChange={e => setKeyword(e.target.value)} /> | ||
| + | <List items={items} onSelect={handleSelect} /> | ||
| + | </> | ||
| + | ); | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ==== 2. 作为 useEffect / useMemo 的依赖 ==== | ||
| + | |||
| + | 稳定的函数引用能避免 effect 被无谓地反复执行: | ||
| + | |||
| + | <code javascript> | ||
| + | const fetchData = useCallback(async () => { | ||
| + | const res = await fetch(`/ | ||
| + | setData(await res.json()); | ||
| + | }, [id]); | ||
| + | |||
| + | useEffect(() => { | ||
| + | fetchData(); | ||
| + | }, [fetchData]); | ||
| + | </ | ||
| + | |||
| + | ==== 3. 自定义 Hook 返回函数 ==== | ||
| + | |||
| + | 自定义 Hook 返回的函数常被调用方放进依赖,稳定引用能避免调用方的 effect 无限循环: | ||
| + | |||
| + | <code javascript> | ||
| + | function useToggle(initial = false) { | ||
| + | const [on, setOn] = useState(initial); | ||
| + | |||
| + | const toggle = useCallback(() => setOn(v => !v), []); | ||
| + | const setTrue = useCallback(() => setOn(true), | ||
| + | |||
| + | return { on, toggle, setTrue }; | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ==== 4. 需要稳定引用的订阅 / 事件注册 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | const handleKeyDown = useCallback(e => { | ||
| + | if (e.key === ' | ||
| + | }, [close]); | ||
| + | |||
| + | useEffect(() => { | ||
| + | window.addEventListener(' | ||
| + | return () => window.removeEventListener(' | ||
| + | }, [handleKeyDown]); | ||
| + | </ | ||
| + | |||
| + | ===== 和 useMemo 的关系 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 下面两种写法完全等价 | ||
| + | const fn = useCallback(() => doSomething(a), | ||
| + | const fn = useMemo(() => () => doSomething(a), | ||
| + | </ | ||
| + | |||
| + | | Hook | 缓存的东西 | 典型用法 | | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 简单记:'' | ||
| + | |||
| + | ===== 什么时候不需要 useCallback ===== | ||
| + | |||
| + | **这是最重要的一节。** 滥用 '' | ||
| + | |||
| + | 遇到下面的情况**不需要**用它: | ||
| + | |||
| + | | 情况 | 说明 | | ||
| + | | 函数只在本组件内用,不传给 '' | ||
| + | | 子组件没有用 '' | ||
| + | | 函数不放进任何依赖数组 | 没人比较它的引用 | | ||
| + | | 依赖项本身每次都变 | 缓存必然失效,等于白写 | | ||
| + | | 只是想在事件里调用的箭头函数 | 写在 JSX 里最直观 | | ||
| + | |||
| + | 判断标准可以简化成一句话:**「这个函数的引用,会不会被别人拿去比较?」** 会,就用 '' | ||
| + | |||
| + | 另外,React 19 / React Compiler 能自动完成这类记忆化,新项目里这类手动优化的重要性正在下降;但理解它仍然是读懂现有代码的前提。 | ||
| + | |||
| + | ===== 常见坑 ===== | ||
| + | |||
| + | **1. 以为 '' | ||
| + | |||
| + | 函数内部的变量**仍然是当次渲染的快照**。依赖数组没写全,读到的就是旧值: | ||
| + | |||
| + | <code javascript> | ||
| + | const [count, setCount] = useState(0); | ||
| + | |||
| + | const log = useCallback(() => { | ||
| + | console.log(count); | ||
| + | }, []); // 但依赖为空 | ||
| + | |||
| + | // 点三次 +1 后调用 log(),打印的仍然是 0 | ||
| + | </ | ||
| + | |||
| + | 正确做法是补上依赖 '' | ||
| + | |||
| + | **2. 依赖里放了每次新建的对象** | ||
| + | |||
| + | <code javascript> | ||
| + | // options 每次渲染都是新对象 → 缓存一直失效 | ||
| + | const send = useCallback(() => { ... }, [options]); | ||
| + | |||
| + | // 改成依赖具体字段 | ||
| + | const send = useCallback(() => { ... }, [options.size, | ||
| + | </ | ||
| + | |||
| + | **3. 到处乱包** | ||
| + | |||
| + | 每个组件里的每个函数都套一层 '' | ||
| + | |||
| + | **4. 加上 useCallback 后子组件仍然重渲染** | ||
| + | |||
| + | 常见原因有三个:子组件**没用 '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 缓存白费:内联箭头函数每次都是新引用 | ||
| + | <List onSelect={id => handleSelect(id)} /> | ||
| + | |||
| + | // 正确:直接把稳定函数传下去 | ||
| + | <List onSelect={handleSelect} /> | ||
| + | </ | ||
| + | |||
| + | **5. 在条件或循环中调用** | ||
| + | |||
| + | 和所有 Hook 一样,必须在顶层调用,否则破坏 Hook 顺序、报错。 | ||
| + | |||
| + | **6. 想靠它提升计算性能** | ||
| + | |||
| + | '' | ||
| + | |||
| + | ===== 小结 ===== | ||
| + | |||
| + | * '' | ||
| + | * 它解决的是**引用稳定性**,不是函数执行速度。 | ||
| + | * 场景:**'' | ||
| + | * 依赖数组与 '' | ||
| + | * 用 '' | ||
| + | * 它等价于 '' | ||
| + | * **没有引用比较需求就不要用**,滥用只会增加负担。 | ||
| + | |||
| + | ===== 相关页面 ===== | ||
| + | |||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | |||
| + | ```mdk height=480 color=# | ||
| + | # useCallback | ||
| + | |||
| + | ## 是什么 | ||
| + | - React 内置 Hook | ||
| + | - 多次渲染间复用同一个函数引用 | ||
| + | - 不是让函数跑得更快 | ||
| + | - 解决的是「引用稳定性」 | ||
| + | - 必须写在组件顶层 | ||
| + | |||
| + | ## 为什么需要 | ||
| + | - 组件每次渲染都重建函数 | ||
| + | - 函数是引用类型,每次都是新对象 | ||
| + | - 传给 React.memo 子组件 → 被迫重渲染 | ||
| + | - 作为 useEffect 依赖 → effect 反复执行 | ||
| + | - 作为 useMemo 依赖 → 缓存失效 | ||
| + | |||
| + | ## 基本语法 | ||
| + | - `const fn = useCallback(() => {}, [deps])` | ||
| + | - 依赖不变 → 返回同一个函数 | ||
| + | - 依赖变化 → 创建新函数 | ||
| + | - `[]` → 永远复用第一个 | ||
| + | |||
| + | ## 依赖数组 | ||
| + | - Object.is 浅比较 | ||
| + | - 漏写依赖 → 闭包读到旧值 | ||
| + | - 依赖里放新建对象 → 缓存失效 | ||
| + | - 优先依赖原始值 | ||
| + | - 用 setState 函数式更新减少依赖 | ||
| + | |||
| + | ## 常见场景 | ||
| + | - 配合 React.memo 的子组件(主要场景) | ||
| + | - 作为 useEffect / useMemo 的依赖 | ||
| + | - 自定义 Hook 返回的函数 | ||
| + | - 事件订阅的稳定回调 | ||
| + | |||
| + | ## 与 useMemo 的关系 | ||
| + | - `useCallback(fn, | ||
| + | - useMemo 缓存「值」 | ||
| + | - useCallback 缓存「函数」 | ||
| + | |||
| + | ## 什么时候不用 | ||
| + | - 没传给 memo 子组件 | ||
| + | - 子组件没包 React.memo | ||
| + | - 函数不进任何依赖数组 | ||
| + | - 依赖本身每次都变 | ||
| + | - 判断标准:引用会不会被别人比较 | ||
| + | |||
| + | ## 常见坑 | ||
| + | - 以为它冻结了闭包里的值 | ||
| + | - 依赖里放了每次新建的对象 | ||
| + | - 到处乱包,反而更慢 | ||
| + | - 子组件没加 memo | ||
| + | - JSX 内联箭头函数破坏缓存 | ||
| + | - 在条件 / 循环里调用 | ||
| + | - 靠它提升计算性能(该用 useMemo) | ||
| + | |||
| + | ## 小结 | ||
| + | - 保持函数引用稳定 | ||
| + | - 依赖规则同 useEffect | ||
| + | - 有引用比较需求才用 | ||
| + | - 滥用不如不用 | ||
| + | ``` | ||