useSyncExternalStore
一句话解释
useSyncExternalStore 将 React 连接到外部状态(Redux、Zustand),并发安全订阅。
用大白话说
useSyncExternalStore(React 18)是从外部存储(Redux、Zustand、浏览器 API)读取的官方方式,与并发渲染安全。它接收三个参数:1. subscribe——注册在存储变化时触发的回调
getSnapshot——读取当前值(未变化时必须返回相同引用)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 现在在底层使用它。它是任何外部存储的低级原语,不特定于任何状态库。
相关术语
相关资源
相关课程
- React 18 特性
useSyncExternalStore。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。