Skip to content

useSyncExternalStore

一句话解释

useSyncExternalStore 将 React 连接到外部状态(Redux、Zustand),并发安全订阅。

用大白话说

useSyncExternalStore(React 18)是从外部存储(Redux、Zustand、浏览器 API)读取的官方方式,与并发渲染安全。它接收三个参数:1. subscribe——注册在存储变化时触发的回调

  1. getSnapshot——读取当前值(未变化时必须返回相同引用)
  2. getServerSnapshot(可选)——SSR 期间读取值没有它,外部存储读取在并发模式下可能导致「撕裂」——UI 不同部分显示同一存储的不同值。此 hook 防止这种情况。

示例

jsx
import { useSyncExternalStore } from "react";

// Simple external store
let count = 0;
const listeners = new Set();
const store = {
  subscribe(cb) { listeners.add(cb); return () => listeners.delete(cb); },
  getSnapshot() { return count; },
  increment() { count++; listeners.forEach(cb => cb()); },
};

function Counter() {
  const value = useSyncExternalStore(
    store.subscribe, store.getSnapshot
  );
  return <button onClick={store.increment}>Count: {value}</button>;
}

useSyncExternalStore 安全地将 React 连接到外部状态。存储通过 subscribe 通知 React 变化,React 通过 getSnapshot 读取。

常见混淆

  • 容易混淆的对象: useSelector

    关键区别: useSelector 是 Redux 专有 hook。useSyncExternalStore 是 React 内置的,Redux/Zustand 现在在底层使用它。它是任何外部存储的低级原语,不特定于任何状态库。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表