一、核心定义(官方准确定义)
- 1.执行时机:组件渲染完成、DOM 已更新、ref 已绑定之后 执行(固定时序,不可改变)
- 2.触发条件:由依赖数组控制是否执行(不是改变时机,是控制是否运行)
- useEffect中执行的逻辑会根据useEffect函数的第二个参数数组中的内容变化控制是否执行第一个参数函数中逻辑执行
- 3.核心用途:专门处理React 之外的系统同步(DOM 操作、视频 / 音频、定时器、接口请求、服务器连接、日志上报等)
二、React 渲染生命周期时序图(必记)
1. 组件函数执行 → 计算JSX(渲染阶段)
↓ (此时 DOM 未生成,ref 为 null,禁止操作外部系统)
2. React 更新 DOM → 绑定 ref
↓
3. 【渲染完成】
↓
4. 执行 useEffect 回调
(此时 DOM 就绪,操作安全)
三、关键对比:函数体 vs useEffect
- 直接写在组件函数体里(错误写法)
import { useState, useRef, useEffect } from "react";
function VideoPlayer({ src, isPlaying }) {
console.log("xiaomai VideoPlayer......");
const ref = useRef(null);
/** 错误写法!!!!❌❌❌❌
* 当前这个示例中不使用useEffect好像也能跑?因为if (ref.current) { ... }跳过了第一次渲染,只在后续更新时执行,看起来'能用',但是这只是巧合,是错误的写法,不是正确的机制
* 错误1: 在组件渲染的过程中直接操作DOM(React 组件函数是用来计算 UI 的,不是执行副作用的) 违背react设计机制,执行操作dom的时机不对
* 错误2: 函数体会无限次数执行,React 组件函数任何时候都可能重新执行 eg:父组件刷新/状态变化/父组件传参变化/甚至react未来的并发渲染
* 错误3: ref 赋值时机不确定
*/
if (ref.current) {
console.log("xiaomai ref 11111===:", ref, isPlaying);
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
}
return <video ref={ref} src={src} loop playsInline />;
}
export default function App() {
const [isPlaying, setIsPlaying] = useState(false);
return (
<>
<button onClick={() => setIsPlaying(!isPlaying)}>
{isPlaying ? "暂停" : "播放"}
</button>
<VideoPlayer
isPlaying={isPlaying}
src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
/>
</>
);
}
- 执行时机:渲染期间(React 计算 UI 时)
- 问题:违反 React 规则,依赖ref.current运气赋值,多余执行,不可控
- 表象:简单场景不报错,但本质错误、生产环境易出 BUG
- 在开发环境严格严重StrictMode模式情况下,每一次更新isPlaying时候if (ref.current) {中的逻辑} 都会执行两次,不报错是因为浏览器兼容重复调用操作vedio的控制播放函数
- 写在 useEffect 里(正确写法)
import { useState, useRef, useEffect } from "react";
function VideoPlayer({ src, isPlaying }) {
console.log("xiaomai VideoPlayer......");
const ref = useRef(null);
/* 正确写法✅✅✅✅
* useEffect:渲染后执行,专门用来和外部系统(视频、DOM、服务器)同步
* 注意: useEffect = 渲染后执行 + 依赖变化才触发 这里依赖的数组[isPlaying]是控制触发条件,只有isPlaying变化时候才会执行里面的逻辑
* 终极正确理解:1.时机:所有 useEffect 都是渲染后执行(DOM 已更新) 2.依赖数组决定这次渲染后要不要执行
* 为什么 useEffect 才是正确的?useEffect 的核心规则:在渲染完成、DOM 真正生成后,才会执行里面的代码
*/
useEffect(() => {
console.log("xiaomai VideoPlayer useEffect......", ref, isPlaying);
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
}, [isPlaying]);
return <video ref={ref} src={src} loop playsInline />;
}
export default function App() {
const [isPlaying, setIsPlaying] = useState(false);
return (
<>
<button onClick={() => setIsPlaying(!isPlaying)}>
{isPlaying ? "暂停" : "播放"}
</button>
<VideoPlayer
isPlaying={isPlaying}
src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
/>
</>
);
}
- 执行时机:渲染完成后
- 优势:时机安全、触发可控、符合 React 设计、无隐形风险
- 在react严格校验模式下,useEffect中的逻辑执行触发条件是数组中的元素是否发生变化,不会产生重复的逻辑执行
四、两个易混淆说法的澄清
- useEffect 渲染后执行
→ 描述执行时机,永远正确,底层规则 - useEffect 数据变化才执行
→ 描述触发条件,是补充说明,不是时机定义
✅ 完整总结:useEffect 一定在渲染后执行,依赖数组决定本次渲染后是否执行。
五、核心铁律(必背)
- 组件函数体 = 只负责计算 UI,禁止操作 DOM、视频、定时器等外部系统
- 所有外部系统同步、副作用操作,必须放入 useEffect
- 严格模式下执行两次不报错 ≠ 代码正确(是浏览器 API 宽容)
六、完整示例代码(标准用法)
import { useState, useRef, useEffect } from 'react';
// 子组件:使用Effect同步视频状态
function VideoPlayer({ src, isPlaying }) {
const ref = useRef(null);
// 渲染后,根据isPlaying同步视频播放/暂停
useEffect(() => {
if (isPlaying) {
ref.current.play();
} else {
ref.current.pause();
}
}, [isPlaying]);
return <video ref={ref} src={src} loop playsInline />;
}
// 父组件
export default function App() {
const [isPlaying, setIsPlaying] = useState(false);
return (
<>
<button onClick={() => setIsPlaying(!isPlaying)}>
{isPlaying ? '暂停' : '播放'}
</button>
<VideoPlayer
isPlaying={isPlaying}
src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
/>
</>
);
}
七、最终结论
- 操作 DOM / 视频 / 外部系统 = 必须用 useEffect
- 区别核心是执行时机,不是执行次数
- 函数体渲染期间 → 只算 UI;useEffect 渲染后 → 操作外部系统
- 不要用 “没报错” 证明代码正确,要遵循 React 设计规则