React / 系统课时

使用 useEffect 处理副作用

使用 useEffect 处理副作用

本课解决组件如何在渲染完成后执行请求、事件订阅和 DOM 同步的问题。你将掌握 useEffect 的执行阶段、依赖数组规则,并能判断一段逻辑是否真的应该放进 Effect。

学习目标

  • 理解副作用与组件渲染之间的边界
  • 正确选择无依赖、空数组和指定依赖三种写法
  • 使用 useEffect 完成请求、订阅与 DOM 同步

副作用为什么不能直接写在渲染中

React 组件的主体用于根据 props 和 state 计算界面。这个计算应保持纯净:相同输入得到相同 JSX,并且不会在计算过程中修改组件外部环境。

网络请求、定时器、事件监听、浏览器标题修改都属于副作用。它们需要在 React 把本次结果提交到 DOM 后执行,否则一次尚未提交或被放弃的渲染也可能触发外部操作。

useEffect 在渲染周期中的位置

依赖数组决定何时重新同步

useEffect(setup, dependencies) 接收一个副作用函数和依赖数组。React 会在提交 DOM 后运行 setup;当依赖发生变化时,先执行上一次返回的清理函数,再运行新的 setup。

写法 执行时机 常见用途
不传依赖数组 每次提交后都执行 少数确实需要跟随每次渲染同步的逻辑
传入 [] 组件挂载后执行 建立一次订阅或加载固定资源
传入 [a, b] 挂载后执行,且 a 或 b 变化后重新执行 让外部系统跟随指定状态同步

依赖项使用 Object.is 比较。组件内读取的 props、state、函数和变量通常都是响应式值,只要 Effect 使用了它们,就应放进依赖数组,而不是通过少写依赖来控制执行次数。

主示例:请求、订阅与 DOM 同步

下面的示例可直接放入 Vite React 项目的 src/main.jsx。它在挂载后加载用户资料,监听窗口宽度变化,并在资料变化后同步浏览器标题。

js
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 />);

预期结果:

text
页面先显示“正在加载用户资料...”,约 500 毫秒后显示“当前用户:Ada”和职位。
调整浏览器窗口宽度后,页面中的像素值随之变化。
浏览器标签标题最终变为“Ada - 控制台”。

三个 Effect 各自只负责一种外部同步。请求 Effect 使用空依赖数组,窗口监听只在挂载和卸载时建立与移除,标题 Effect 则明确依赖 profile。

不该使用 Effect 的场景

能够在渲染期间直接算出的值,不要先放入 state 再用 Effect 更新。例如全名可以由名字和姓氏直接拼接;筛选列表也可以由源数组和筛选条件计算。多余的 Effect 会造成额外渲染,并让数据来源变得不清晰。

由用户点击、提交等明确事件触发的操作,通常应放在事件处理函数中。Effect 适合“组件已经出现在页面上,需要与外部系统保持同步”的情况,而不是所有命令式代码的统一容器。

开发环境启用 StrictMode 时,React 可能额外执行一次 setup 与 cleanup,用于暴露不完整的清理逻辑。这不是生产环境重复执行,但 Effect 仍应设计成可以安全地重新建立。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 useEffect 处理副作用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通