Skip to content

条件 Hook 调用违反 hooks 规则

快速摘要

你在 if 语句中调用了 hook —— React 要求每次渲染以相同顺序调用 hook。

为什么发生

  • hook 在条件块(if/else)中调用,某些渲染可能跳过

  • hook 在可能每次渲染执行不同次数的循环或动态函数中调用

  • hook 调用前的提前返回意味着某些渲染跳过该 hook

最小示例

✗ 错误代码
function Profile({ user }) {
  if (!user) return <Loading />;
  const [data, setData] = useState(null); // hook after early return!
  return <div>{data}</div>;
}
✓ 修复代码
function Profile({ user }) {
  const [data, setData] = useState(null); // hook always called
  if (!user) return <Loading />;
  return <div>{data}</div>;
}

将 hook 移到提前返回之前确保每次渲染都调用,遵循 hooks 规则。

如何诊断

  • 查找 React 错误:'Rendered more hooks than during the previous render'

  • 检查所有 hook 的条件、循环或提前返回位置是否可能改变调用顺序

  • 使用 eslint-plugin-react-hooks 的 rules-of-hooks 规则检测条件 hook 调用

如何修复

  • 将 hook 调用移到组件顶层,在任何条件或提前返回之前

  • 将条件移到 hook 内:useEffect(() => { if (condition) doSomething(); }) 而非 if (condition) useEffect(...)

  • 拆分组件使条件渲染不同组件,每个都有自己的顶层 hook

如何预防

  • 始终在组件顶层调用 hook —— 永远不在条件、循环或嵌套函数内

  • 启用 rules-of-hooks eslint 规则在构建时捕获违规

相关资源

相关术语

相关课程

← 返回语言