React / 系统课时
使用 useEffect
使用 useEffect
useEffect 用来把 React 组件与组件外部系统同步,例如浏览器事件、网络连接、订阅或手动控制的第三方实例。本节会用一个在线状态订阅示例,掌握副作用的启动、清理时机,以及何时根本不该写 Effect。
学习目标
- 理解 Effect 在渲染提交后的执行时机
- 能为订阅类副作用同时编写 setup 与 cleanup
- 能区分外部同步与可直接在渲染阶段计算的逻辑
Effect 解决的不是“任意异步”
React 渲染函数应该根据 props 和 state 计算界面,不负责持续管理组件外部的资源。useEffect(setup, dependencies) 会在本次界面提交到屏幕后运行 setup;当依赖变化且需要重新执行时,React 会先运行上一次返回的清理函数,再执行新的 setup;组件卸载时也会执行最后一次清理。
这使它适合连接外部系统,例如监听 window 事件、创建 WebSocket、订阅消息源或同步非 React 小部件。仅仅为了根据两个 state 计算第三个值,通常不需要 Effect,直接在渲染期间计算更简单。

订阅外部事件
下面的组件订阅浏览器的在线与离线事件。Effect 负责注册监听器,返回的函数负责解除监听器,两者必须成对出现,避免组件卸载后仍保留无效订阅。
import { useEffect, useState } from 'react';
export default function App() {
const [isOnline, setIsOnline] = useState(navigator.onLine);
useEffect(() => {
function handleOnline() {
setIsOnline(true);
}
function handleOffline() {
setIsOnline(false);
}
// setup:把组件连接到浏览器事件系统。
window.addEventListener('online', handleOnline);
window.addEventListener('offline', handleOffline);
return () => {
// cleanup:撤销本次 setup 建立的两个订阅。
window.removeEventListener('online', handleOnline);
window.removeEventListener('offline', handleOffline);
};
}, []);
return <p>{isOnline ? '网络已连接' : '网络已断开'}</p>;
}预期结果
页面初始显示“网络已连接”或“网络已断开”,与 navigator.onLine 一致。
浏览器触发 online/offline 事件后,文本随之更新。
组件卸载时两个事件监听器会被移除。这里的空依赖数组表示此 Effect 不读取会随渲染变化的响应式值,因此生产环境下一次挂载只需要建立一次订阅。开发环境启用 Strict Mode 时,React 可能额外执行一次“setup → cleanup → setup”来检查清理逻辑是否完整;这不是生产环境中的重复订阅。
清理函数决定副作用是否安全
凡是 Effect 创建了持续存在的外部资源,都应考虑对应的逆操作:添加监听器对应移除监听器,建立连接对应断开连接,启动计时器对应清除计时器。清理函数不应该只是“为了消除警告”,而是要把外部系统恢复到本次 Effect 执行之前的状态。
对于网络请求,旧请求即使不能完全阻止,也要避免过期结果覆盖新状态。常见做法是使用 AbortController 取消请求,或在清理阶段标记当前请求已经失效。
先问是否真的需要 Effect
写 Effect 前先判断:这段逻辑是否在同步 React 之外的系统。如果答案是否定的,例如过滤列表、拼接字符串、根据 props 计算派生值,就直接在渲染阶段完成。Effect 越少,组件越容易理解,也越不容易出现重复执行、竞态和清理遗漏。