React / 系统课时
Hooks 使用规则
Hooks 使用规则
Hooks 让函数组件拥有状态和副作用能力,但它们不能像普通函数一样随意调用。本课从 React 依赖“调用顺序”识别 Hook 的机制出发,说明顶层调用规则、合法位置和常见违规写法,帮助你在编码阶段就避免状态错位。
学习目标
- 记住 Hooks 的两条核心调用规则
- 理解条件调用为什么会造成状态关联错误
- 使用合法结构重写条件逻辑和嵌套逻辑
两条必须遵守的规则
第一,Hook 只能在 React 函数组件或自定义 Hook 中调用。普通工具函数、事件处理函数和模块顶层都不是合法位置。
第二,Hook 必须在组件或自定义 Hook 的顶层调用,不能放进条件、循环、嵌套函数、try 语句或提前返回之后。这里的“顶层”指每次渲染都会以相同顺序执行的位置。

React 为什么依赖固定顺序
在一次组件渲染中,React 会按照 Hook 的调用先后保存状态槽位。第一次调用对应第一个槽位,第二次调用对应第二个槽位。下一次渲染时,React 仍按相同顺序取回这些槽位。
如果某次渲染因为条件分支少调用一个 Hook,后面的 Hook 就会读取错误槽位。React 无法仅凭变量名判断哪个状态属于哪个 useState,因此必须要求调用顺序稳定。
正确写法:Hook 固定调用,条件放进内部
下面的组件始终调用两个 Hook,只把条件判断放进 useEffect 内部。无论 enabled 是真是假,Hook 顺序都不会改变。
import { useEffect, useState } from "react";
export default function App() {
const [enabled, setEnabled] = useState(false);
const [message, setMessage] = useState("尚未启用");
useEffect(() => {
// Hook 始终执行,只有副作用内容受条件控制
if (enabled) {
setMessage("功能已启用");
} else {
setMessage("尚未启用");
}
}, [enabled]);
return (
<main>
<button onClick={() => setEnabled((value) => !value)}>
切换状态
</button>
<p>{message}</p>
</main>
);
}预期结果:页面初始显示“尚未启用”;点击按钮后显示“功能已启用”;再次点击恢复为“尚未启用”,控制台不会出现 Hook 顺序错误。
尚未启用
点击后:功能已启用
再次点击:尚未启用典型违规写法与改写方向
下面是条件调用的片段示例,依赖 React 组件上下文,不能独立运行。它的问题是 enabled 改变后,useEffect 可能被跳过。
if (enabled) {
useEffect(() => {
document.title = "已启用";
}, []);
}预期结果不是正常运行结果,而是代码检查阶段应报告 Hooks 规则错误;修复方式是始终调用 useEffect,再在回调内部判断 enabled。
事件处理函数中也不能临时创建 Hook。事件函数可以调用状态更新函数,但 Hook 本身必须在组件渲染顶层创建。
function handleClick() {
const [count, setCount] = useState(0);
setCount(count + 1);
}该片段同样依赖组件上下文且不能独立运行。正确做法是把 useState 移到组件顶层,让 handleClick 只调用已有的 setCount。
自定义 Hook 的合法边界
自定义 Hook 是以 use 开头的函数,它可以组合其他 Hook,但自身也必须遵守相同规则。组件调用自定义 Hook 时,仍要放在顶层,不能借助封装绕过条件调用限制。
条件逻辑应放在 Hook 内部,或通过参数控制行为。例如自定义 Hook 可以接收 enabled,但内部的 useEffect 仍然每次都要调用。
实际项目中应启用 ESLint 的 Hooks 规则。rules-of-hooks 用于发现非法调用位置,exhaustive-deps 用于检查副作用依赖;前者保障调用顺序,后者保障副作用读取到最新值。