React / 系统课时
使用 useEffect 处理副作用
使用 useEffect 处理副作用
本课解决组件如何在渲染完成后执行请求、事件订阅和 DOM 同步的问题。你将掌握 useEffect 的执行阶段、依赖数组规则,并能判断一段逻辑是否真的应该放进 Effect。
学习目标
- 理解副作用与组件渲染之间的边界
- 正确选择无依赖、空数组和指定依赖三种写法
- 使用
useEffect完成请求、订阅与 DOM 同步
副作用为什么不能直接写在渲染中
React 组件的主体用于根据 props 和 state 计算界面。这个计算应保持纯净:相同输入得到相同 JSX,并且不会在计算过程中修改组件外部环境。
网络请求、定时器、事件监听、浏览器标题修改都属于副作用。它们需要在 React 把本次结果提交到 DOM 后执行,否则一次尚未提交或被放弃的渲染也可能触发外部操作。

依赖数组决定何时重新同步
useEffect(setup, dependencies) 接收一个副作用函数和依赖数组。React 会在提交 DOM 后运行 setup;当依赖发生变化时,先执行上一次返回的清理函数,再运行新的 setup。
| 写法 | 执行时机 | 常见用途 |
|---|---|---|
| 不传依赖数组 | 每次提交后都执行 | 少数确实需要跟随每次渲染同步的逻辑 |
传入 [] |
组件挂载后执行 | 建立一次订阅或加载固定资源 |
传入 [a, b] |
挂载后执行,且 a 或 b 变化后重新执行 |
让外部系统跟随指定状态同步 |
依赖项使用 Object.is 比较。组件内读取的 props、state、函数和变量通常都是响应式值,只要 Effect 使用了它们,就应放进依赖数组,而不是通过少写依赖来控制执行次数。
主示例:请求、订阅与 DOM 同步
下面的示例可直接放入 Vite React 项目的 src/main.jsx。它在挂载后加载用户资料,监听窗口宽度变化,并在资料变化后同步浏览器标题。
import { useEffect, useState } from 'react';
import { createRoot } from 'react-dom/client';
function loadProfile() {
return new Promise((resolve) => {
setTimeout(() => {
resolve({ name: 'Ada', role: 'Frontend Engineer' });
}, 500);
});
}
function App() {
const [profile, setProfile] = useState(null);
const [width, setWidth] = useState(window.innerWidth);
useEffect(() => {
let active = true;
loadProfile().then((data) => {
if (active) {
setProfile(data);
}
});
return () => {
active = false;
};
}, []);
useEffect(() => {
const updateWidth = () => setWidth(window.innerWidth);
window.addEventListener('resize', updateWidth);
return () => window.removeEventListener('resize', updateWidth);
}, []);
useEffect(() => {
document.title = profile ? `${profile.name} - 控制台` : '资料加载中';
}, [profile]);
return (
<main>
<h1>{profile ? `当前用户:${profile.name}` : '正在加载用户资料...'}</h1>
<p>{profile ? `职位:${profile.role}` : '请稍候'}</p>
<p>窗口宽度:{width}px</p>
</main>
);
}
createRoot(document.getElementById('root')).render(<App />);预期结果:
页面先显示“正在加载用户资料...”,约 500 毫秒后显示“当前用户:Ada”和职位。
调整浏览器窗口宽度后,页面中的像素值随之变化。
浏览器标签标题最终变为“Ada - 控制台”。三个 Effect 各自只负责一种外部同步。请求 Effect 使用空依赖数组,窗口监听只在挂载和卸载时建立与移除,标题 Effect 则明确依赖 profile。
不该使用 Effect 的场景
能够在渲染期间直接算出的值,不要先放入 state 再用 Effect 更新。例如全名可以由名字和姓氏直接拼接;筛选列表也可以由源数组和筛选条件计算。多余的 Effect 会造成额外渲染,并让数据来源变得不清晰。
由用户点击、提交等明确事件触发的操作,通常应放在事件处理函数中。Effect 适合“组件已经出现在页面上,需要与外部系统保持同步”的情况,而不是所有命令式代码的统一容器。
开发环境启用 StrictMode 时,React 可能额外执行一次 setup 与 cleanup,用于暴露不完整的清理逻辑。这不是生产环境重复执行,但 Effect 仍应设计成可以安全地重新建立。