大网数据广告活动
React 前端开发

Hook 的规则

· 52CE 我爱测

Hook 是使用 JavaScript 函数定义的,但它们代表了一种特殊的可重用的 UI 逻辑,并且对它们可以被调用的位置有限制。

Hook 是使用 JavaScript 函数定义的,但它们代表了一种特殊的可重用的 UI 逻辑,并且对它们可以被调用的位置有限制。


只在顶层调用 Hook {/only-call-hooks-at-the-top-level/}

在 React 中,以 use 开头命名的函数被称为 Hook。

不要在循环、条件语句、嵌套函数或 try/catch/finally 代码块中调用 Hook。相反,你应该在 React 函数组件的顶层使用 Hook,且在任何提前返回之前。你只能在 React 渲染函数组件时调用 Hook:

function Counter() {
  // ✅ 正确的:在函数组件顶层
  const [count, setCount] = useState(0);
  // ...
}

function useWindowWidth() {
  // ✅ 正确的:在自定义 Hooks 顶层
  const [width, setWidth] = useState(window.innerWidth);
  // ...
}

不支持在其他任何情况下调用以 use 开头的 Hook,例如:

  • 🔴 不要在条件语句或循环中调用 Hook。
  • 🔴 不要在条件性的 return 语句之后调用 Hook。
  • 🔴 不要在事件处理函数中调用 Hook。
  • 🔴 不要在类组件中调用 Hook。
  • 🔴 不要在传递给 useMemo、useReducer 或 useEffect 的函数内部调用 Hook。
  • 🔴 不要在 try/catch/finally 代码块中调用 Hook。

如果你违反了这些规则,你可能会看到以下错误:

function Bad({ cond }) {
  if (cond) {
    // 🔴 错误的:在条件语句内部(要修复这个问题,将其移到外部!)
    const theme = useContext(ThemeContext);
  }
  // ...
}

function Bad() {
  for (let i = 0; i < 10; i++) {
    // 🔴 错误的:在循环语句内部(要修复这个问题,将其移到外部!)
    const theme = useContext(ThemeContext);
  }
  // ...
}

function Bad({ cond }) {
  if (cond) {
    return;
  }
  // 🔴 错误的:在条件性 return 语句之后(要修复这个问题,将其移到 return 之前!)
  const theme = useContext(ThemeContext);
  // ...
}

function Bad() {
  function handleClick() {
    // 🔴 错误的:在事件处理函数内部(要修复这个问题,将其移到 return 之前!)
    const theme = useContext(ThemeContext);
  }
  // ...
}

function Bad() {
  const style = useMemo(() => {
    // 🔴 错误的:在 useMemo 内部调用(要修复这个问题,将其移到外部!)
    const theme = useContext(ThemeContext);
    return createStyle(theme);
  });
  // ...
}

class Bad extends React.Component {
  render() {
    // 🔴 错误的:在类组件内部调用(要修复这个问题,改写为函数组件!)
    useEffect(() => {})
    // ...
  }
}

function Bad() {
  try {
    // 🔴 错误的:在 try、catch、finally 代码块内部调用(要修复这个问题,将其移到外部!)
    const [x, setX] = useState(0);
  } catch {
    const [x, setX] = useState(1);
  }
}

你可以使用 eslint-plugin-react-hooks 插件 来捕获这些错误。

自定义 Hook 可以 调用其他 Hook(这正是它们的主要目的)。之所以可以这样做,是因为自定义 Hook 也应该只在函数组件渲染时被调用。


仅在 React 函数中调用 Hook {/only-call-hooks-from-react-functions/}

不要在常规的 JavaScript 函数中调用 Hook。相反,你可以:

✅ 在 React 函数组件中调用 Hook。 ✅ 在 自定义 Hook 中调用 Hook。

遵循这条规则,你可以确保组件中的所有状态逻辑在其源代码中清晰可见。

function FriendList() {
  const [onlineStatus, setOnlineStatus] = useOnlineStatus(); // ✅
}

function setOnlineStatus() { // ❌ 不是一个组件或自定义 Hook!
  const [onlineStatus, setOnlineStatus] = useOnlineStatus();
}

本文来自 React 文档中文译者及贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
React 文档中文译者及贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。