React useEffect 完全指南:从原理到实战的深度解析

一、什么是副作用

副作用 = 渲染 UI 之外的一切外部操作。

属于副作用 不属于(渲染逻辑) DOM 操作、网络请求 纯计算、生成 JSX 定时器、事件订阅 条件判断 localStorage 读写、日志埋点 ---

React 要求渲染保持纯净,副作用统一放进 useEffect,由 React 控制执行时机和清理。

核心心智模型:useEffect 不是"生命周期替代品",而是"副作用与哪些 state/props 保持同步"。


二、语法与执行机制

javascript 复制代码
useEffect(() => {
  // 副作用逻辑
  return () => { /* 清理函数 */ };
}, [dependencies]);

三种依赖写法的执行规律(生产环境):

写法 挂载时 更新时 卸载时 不传依赖 useEffect(fn) 1 次 每次渲染后都执行 执行 cleanup 空依赖 useEffect(fn, \[\]) 1 次 不执行 执行 cleanup 有依赖 useEffect(fn, a) 1 次 a 变化时执行 执行 cleanup

执行时机:render → DOM 更新 → 浏览器绘制 → effect 执行(异步,绘制后)。

清理时机:下次 effect 执行前 / 组件卸载时。


三、"执行两次"的真相

开发环境 + StrictMode 下,空依赖 effect 会执行两次(run → cleanup → run),这是 React 18 故意模拟卸载再挂载,目的是暴露清理不当的 bug。

环境 执行次数 生产环境 1 次 开发环境 + StrictMode 2 次(仅挂载阶段)

生产构建不受影响,无需"修复",只需保证 cleanup 干净、effect 幂等。


四、常见场景

javascript 复制代码
// 数据请求(处理竞态)
useEffect(() => {
  let cancelled = false;
  fetch(`/api/user/${userId}`)
    .then(r => r.json())
    .then(d => { if (!cancelled) setUser(d); });
  return () => { cancelled = true; };
}, [userId]);

// 事件监听
useEffect(() => {
  const handler = () => setWidth(window.innerWidth);
  window.addEventListener('resize', handler);
  return () => window.removeEventListener('resize', handler);
}, []);

五、四大陷阱

  1. 引用比较陷阱:对象/数组/函数每次渲染都是新引用,导致无限循环 → 用 useMemo/useCallback 稳定。

  2. 闭包陷阱:旧 effect 捕获旧 state → 用函数式更新或 useRef 存最新值。

  3. 依赖不完整:不要忽略 exhaustive-deps 警告。

  4. 同步阻塞:effect 中避免大量同步计算。


六、最佳实践

  1. 每个 effect 只做一件事
  2. 依赖数组要完整
  3. 善用清理函数防内存泄漏
  4. 请求处理竞态(cancelled / AbortController)
  5. 引用类型依赖用 useMemo/useCallback 稳定
  6. 复用逻辑抽离为自定义 Hook
javascript 复制代码
// 自定义 Hook 示例
function useWindowWidth() {
  const [width, setWidth] = useState(window.innerWidth);
  useEffect(() => {
    const h = () => setWidth(window.innerWidth);
    window.addEventListener('resize', h);
    return () => window.removeEventListener('resize', h);
  }, []);
  return width;
}

一句话总结

useEffect 是同步机制:把组件状态与外部世界保持同步。从"在某个时机执行代码"转向"声明副作用依赖哪些值",陷阱自然消失。

相关推荐
用户298698530142 天前
React 前端实现 Word 与 OpenXML 双向转换的完整实践
javascript·react.js
月夏3 天前
我把全栈项目塞进已有 nginx 的服务器,卡我最久的是三个斜杠
nginx·react.js·docker
清晨Coding6 天前
为什么用 React Developer Tools 查看组件树这么乱?
前端·react.js
生活的囚徒7 天前
从一堆Excel到一套系统:项目管理+研发管理双门户的落地实践
react.js
ZhengEnCi8 天前
React 19 加 Vite 6 企业级前端项目目录结构:无路由 SPA、zustand 与 Tailwind 4 的分层架构指南
react.js
用户298698530148 天前
React 前端实现 Excel 与 CSV 互转:基于 WebAssembly 的浏览器端方案
javascript·react.js·excel
Highcharts.js10 天前
Highcharts Orbit 完全指南:把每一张图表变成交互式分析工具
react.js·前端框架·highcharts·orbit·使用指南·ai 图表·交互式分析工具
鸿蒙开发10 天前
小程序存档写到一半怎么办?双槽保存与损坏恢复实战
前端·javascript·react.js
古茗前端团队12 天前
由 key 引发的思考
前端·javascript·react.js