React / 知识点

React Hooks 速查手册

手册条目

确认 Hook 只能在函数组件或自定义 Hook 顶层调用,避免调用顺序不稳定。

遵守 Hooks 调用规则

Hook 调用顺序依赖 React 在每次渲染中的固定位置。本文用于定位 Hooks 规则错误,确保 Hook 只在允许的位置调用,避免状态错位、运行时警告或构建检查失败。

使用位置

React Hook 只能在两类位置调用:

  • 函数组件的顶层。
  • 自定义 Hook 函数的顶层。

不要在普通函数、条件分支、循环、事件处理函数或 try/catch 内直接调用 Hook。

正确写法

jsx
import { useState, useEffect } from 'react';

function UserPanel({ id }) {
  const [name, setName] = useState('');

  // Hook 保持在组件顶层,React 可以稳定记录调用顺序
  useEffect(() => {
    setName(`user-${id}`);
  }, [id]);

  return <div>{name}</div>;
}

预期结果

text
页面显示:user-123
读取方式:组件每次渲染时,useState 和 useEffect 按固定顺序执行

高频错误

条件调用会导致不同渲染阶段 Hook 数量变化:

jsx
function Panel({ enabled }) {
  if (enabled) {
    const [value] = useState(0);
  }

  return <div />;
}

可能出现:

text
Error: Rendered fewer hooks than expected

修复方式是保持 Hook 始终执行,把条件放到 Hook 内部:

jsx
useEffect(() => {
  if (!enabled) return;
  loadData();
}, [enabled]);

排障清单

  • 搜索 useState、useEffect 等调用位置,确认没有嵌套在 if/for/function 中。
  • 检查自定义 Hook 是否以 use 开头并且只在组件或其他 Hook 中调用。
  • 开启 ESLint Hooks 规则提前发现问题。
json
{
  "rules": {
    "react-hooks/rules-of-hooks": "error"
  }
}

风险提示:如果通过动态调用、条件封装等方式绕过规则,可能导致状态与组件逻辑错位。安全替代方案是拆分组件或拆分自定义 Hook,让每次渲染保持相同调用顺序。

目录与阅读设置

记录一个想法

React Hooks 速查手册

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

登录哪都通