一、什么是副作用
副作用 = 渲染 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);
}, []);
五、四大陷阱
-
引用比较陷阱:对象/数组/函数每次渲染都是新引用,导致无限循环 → 用 useMemo/useCallback 稳定。
-
闭包陷阱:旧 effect 捕获旧 state → 用函数式更新或 useRef 存最新值。
-
依赖不完整:不要忽略 exhaustive-deps 警告。
-
同步阻塞:effect 中避免大量同步计算。
六、最佳实践
- 每个 effect 只做一件事
- 依赖数组要完整
- 善用清理函数防内存泄漏
- 请求处理竞态(cancelled / AbortController)
- 引用类型依赖用 useMemo/useCallback 稳定
- 复用逻辑抽离为自定义 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 是同步机制:把组件状态与外部世界保持同步。从"在某个时机执行代码"转向"声明副作用依赖哪些值",陷阱自然消失。