Skip to content

useCallback 依赖过期

快速摘要

你的 useCallback 依赖数组缺少变量 —— 回调捕获过期值并在稍后调用时使用。

为什么发生

  • 依赖数组省略了回调读取的 state 或 prop 变量

  • 回调使用外部作用域中变化但未列入依赖数组的值

  • 使用空依赖数组但回调读取随时间变化的 props 或 state

最小示例

✗ 错误代码
function SearchBar({ query, onSearch }) {
  const handleSearch = useCallback(() => {
    onSearch(query); // query is stale!
  }, [onSearch]); // query missing from deps
  return <button onClick={handleSearch}>Search</button>;
}
✓ 修复代码
function SearchBar({ query, onSearch }) {
  const handleSearch = useCallback(() => {
    onSearch(query);
  }, [onSearch, query]); // all deps included
  return <button onClick={handleSearch}>Search</button>;
}

将 query 加入依赖数组使 query 变化时回调重建,确保始终读取当前值。

如何诊断

  • 记录回调内的值,检查是否反映当前 props 和 state

  • 使用 exhaustive-deps eslint 规则检测 useCallback 中缺失的依赖

  • 将回调行为与非记忆版本比较以检测过期

如何修复

  • 将回调读取的所有变量添加到 useCallback 的依赖数组

  • 在回调内使用函数式状态更新以避免在依赖中需要状态值

  • 如果函数不传给记忆子组件或不用作 effect 依赖则移除 useCallback

如何预防

  • 始终将回调读取的所有变量包含在依赖数组中

  • 使用 exhaustive-deps eslint 规则并优先使用函数式更新以最小化依赖追踪

相关资源

相关术语

相关课程

← 返回语言