React / 系统课时
Hooks 使用规则
Hooks 使用规则
Hooks 看起来只是普通函数,但 React 需要依靠它们在每次渲染中的稳定调用顺序来关联状态和副作用。把常见 Hook 放进条件、循环或普通回调,就可能破坏这种对应关系,因此调用位置本身也是正确性的组成部分。
学习目标
- 掌握常见 Hooks 的两条基本调用规则
- 理解为什么条件语句和循环中不能随意调用 Hook
- 学会把条件判断移动到 Hook 内部或普通渲染逻辑中
规则不是代码风格约定
对于 useState、useEffect、useContext 等常见 Hooks,第一条规则是必须在函数组件或自定义 Hook 的顶层调用。不要把它们放进 if、for、while、事件处理函数或普通嵌套函数中,也不要放在可能提前返回的语句之后。
第二条规则是 Hook 只能从 React 函数组件或自定义 Hook 中调用。普通 JavaScript 函数没有对应的组件渲染过程,React 无法按照组件实例为其中的 Hook 维护状态。
这些限制的共同目的,是让同一个组件在每次渲染时都以稳定顺序执行 Hooks。
正确地表达条件逻辑
需要“只有满足条件才执行副作用”时,不要有条件地调用 useEffect,而应始终调用 Hook,把条件判断放到 Effect 内部。
import { useEffect, useState } from 'react';
export default function StatusPanel({ connected }) {
const [count, setCount] = useState(0);
// Hook 始终位于组件顶层,条件只控制副作用是否执行。
useEffect(() => {
if (!connected) {
return;
}
document.title = `已处理 ${count} 次`;
}, [connected, count]);
return (
<button onClick={() => setCount((value) => value + 1)}>
处理次数:{count}
</button>
);
}预期结果
初始按钮显示:处理次数:0
每点击一次按钮,数字加 1。
当 connected 为 true 时,页面标题同步更新为“已处理 <VALUE> 次”。其中 <VALUE> 会随点击次数变化。无论 connected 是 true 还是 false,useState 和 useEffect 的调用位置与顺序都保持不变。
条件调用为什么会出错
下面是错误写法。它是片段示例,用于说明规则,依赖外部已导入的 useState,不应直接作为完整组件使用。
function BadPanel({ enabled }) {
if (enabled) {
const [count, setCount] = useState(0);
}
return <div>状态面板</div>;
}当 enabled 从 true 变为 false 时,本次渲染会少调用一个 Hook。React 按调用顺序维护组件中的 Hook 状态;一旦某次渲染插入、跳过或移动了常见 Hook,后续调用就可能无法继续对应原来的状态位置。
因此,需要条件时,应改变 Hook 内部执行的逻辑,而不是改变 Hook 是否被调用。另一种常见做法是把需要独立状态的分支拆成单独组件,让每个组件自己的 Hook 顺序保持稳定。
认识特殊的 use API
React 的 use API 是顶层规则中的特殊情况,它可以出现在条件语句或循环中,因此不要把“所有名称以 use 开头的调用都绝对不能进入条件”机械化理解。不过 use 仍需要在 React 组件或 Hook 的执行过程中使用,并且还有自己的限制。
对于初学阶段最常见的 useState、useEffect、useContext、useMemo 等 Hooks,仍应严格遵守顶层调用规则。这样可以避免把特殊 API 的能力错误套用到普通 Hooks 上。
自定义 Hook 也遵守相同原则
自定义 Hook 用来封装可复用的 Hook 逻辑,函数名通常以 use 开头。它可以调用其他 Hooks,但它自己也应从函数组件或另一个自定义 Hook 的合适位置调用。
Lint 工具能够发现大量违规调用,但真正需要记住的是底层原则:对于普通 Hooks,同一个组件的每次渲染都要保持调用顺序稳定。先保证这一点,条件分支、提前返回和逻辑封装就更容易放到正确的位置。