useState 传函数:惰性初始化、存函数要包两层、严格模式跑两遍
useState 的第一个参数可以接受任何值,但函数有特殊语义:它会被当作初始化函数调用,而不是被保存下来。记住这条规则,可以避开下面几个问题。参考 useState 文档。
一、useState(createInitialTodos) 只跑一次,加括号就每次渲染都跑
initialState 是 state 的初始值。如果把函数传进去,React 会把它视为初始化函数:必须是不接受参数的纯函数,并返回初始 state;React 在初次渲染时调用它,把返回值存为初始 state。
这两行的语义完全不同:
// 🚩 每次渲染都会调用 createInitialTodos()
const [todos, setTodos] = useState(createInitialTodos());
// ✅ 只在初始化时调用一次
const [todos, setTodos] = useState(createInitialTodos);
第一行在每次渲染时都会先执行 createInitialTodos(),把结果作为参数传给 useState,React 只是忽略后续的返回值;但初始化逻辑的耗时仍然会发生。第二行传的是函数本身,React 只调用一次。
当初始 state 计算开销较大(比如遍历大数组、读取 localStorage 并解析)时,就传函数引用,不要加括号。
二、想用 state 存函数,必须包两层箭头函数
同样的规则也作用于 setter:如果向 nextState 传入函数,它会被当作更新函数,React 用待定 state 调用它,并保存返回值。
const [fn, setFn] = useState(someFunction);
setFn(someOtherFunction); // someOtherFunction 被调用了,state 里不是它
这里 someOtherFunction 会被调用,返回值写进 state。要真的把函数本身存进去,初始化和更新都要再包一层:
const [fn, setFn] = useState(() => someFunction);
setFn(() => someOtherFunction);
初始化的这一层箭头函数本身是初始化函数,React 调用它,返回的是 someFunction 这个函数,于是 state 里存住了函数。更新同理。
更新函数有明确要求:纯函数,只接受待定 state 作为唯一参数,返回下一个 state。
三、严格模式下初始化函数与更新函数各跑两次
在 StrictMode 的开发环境中,React 会把初始化函数调用两次,以验证它是否为纯函数,其中一次结果被忽略;更新函数同理。这是开发行为,不影响生产构建。
由此带来两条实际约束:
- 初始化函数里不要做副作用。请求、写 localStorage、改外部变量,在开发模式下都会发生两次。在初始化函数里加
console.log会看到两行输出,原因就在这里。 - 更新函数里只返回结果。不要在内部调用 setState,也不要在内部做副作用,否则双调用会把问题放大。
更新函数在渲染期间执行,因此必须保持纯函数;严格模式下同样执行两次、丢弃第二个结果。
四、函数更新与值更新混在同一队列
同一个 state 上连续调用 set,队列里的更新函数和值替换会按顺序合并。关于队列的规则见 Queueing a Series of State Updates。
setNumber(number + 5);
setNumber(n => n + 1);
setNumber(42); // 最终是 42
最后一条是直接赋值,队列里前面算出的结果会被忽略,state 最终为 42。
还有两个相关行为:set 函数标识稳定,可以省略在 Effect 依赖数组里,写进去也不会导致 Effect 重新触发;在渲染期间调用 set 只允许作用于当前渲染的组件,React 会丢弃本次输出、用新 state 立即重试渲染,这个特性可以用来保存「上一次渲染的信息」。
回到最容易出问题的一点:useState 的参数位置和 set 的参数位置都特殊对待函数。初始值想留函数就写 useState(() => fn),更新想留函数就写 setFn(() => nextFn),其他情况才把函数当作惰性初始化或 updater 使用。