amaranth.log
💻 개발

useEffect와 useLayoutEffect의 차이점에 대해서 설명해주세요

본 포스트는 IT 기술면접 질문 메일링 서비스, 매일메일의 토픽에 대해 추가적으로 학습한 내용을 기록하고자 작성되었습니다. 기술면접 질문 및 답안&해설을 제공해주신 매일메일 서비스에 감사의 말씀 남깁니다.
매일메일 - useEffect와 useLayoutEffect의 차이점에 대해서 설명해주세요.
`useEffect`와 `useLayoutEffect`는 모두 렌더링된 후에 특정 작업을 수행하기 위해 사용됩니다. 하지만 실행되는 **타이밍**과 **용도**가 다릅니다. 먼저, ```useEffect```는 **렌더링이 완료되는 시점**에 **비동기적**으로 실행됩니다. 즉, 화면이 실제로 사용자에게 그려진 후에 ```useEffect```가 실행되는 방식입니다. 그래서 ```useEffect```는 보통 데이터를 가져오는 작업이나 이벤트 리스너 추가 등 렌더링 후에 화면에 직접적인 영향을 주지 않는 작업에 주로 사용됩니다. 반면에 ```useLayoutEffect```는 **렌더링 후 DOM이 업데이트되기 직전의 시점**에 **동기적**으로 실행됩니다. 여기서 **동기적**이라는 것은 화면에 내용이 그려지기 전에 모든 레이아웃 관련 작업이 완료된다는 의미입니다. 예를 들어, **DOM의 크기를 측정**하거나 **위치를 조정해야 할** 때 ```useLayoutEffect```를 사용하면 즉각적으로 그 변경사항이 반영되어 화면 깜빡임이나 불필요한 재렌더링을 방지할 수 있습니다. 정리하면, **렌더링 후 실행되는 비동기 작업**에는 ```useEffect```가 적합하고, 레이아웃 작업이나 DOM 조작과 같이 **화면이 그려지기 전에 완료되어야 하는 작업**에는 ```useLayoutEffect```가 적합합니다. 예를 들면, ```useEffect```는 사용자 데이터를 API로부터 가져오는 상황에 자주 사용합니다. 데이터가 렌더링 후에 설정되면 화면이 자연스럽게 업데이트되는 것입니다. ```jsx useEffect(() => { fetchData().then(data => setData(data)); }, []); ``` ```useLayoutEffect```는 DOM의 크기를 측정해서, 다른 요소의 위치를 조정해야 할 때 유용합니다. 예를 들어, 어떤 요소의 높이를 측정해 그 높이에 맞춰 레이아웃을 맞추고 싶을 때 사용합니다: ```jsx useLayoutEffect(() => { const height = ref.current.offsetHeight; setHeight(height); }, []); ``` 단, ```useLayoutEffect``` 사용 시 **성능 면에서 주의할 점**이 있습니다. ```useLayoutEffect```는 동기적으로 실행되기 때문에 너무 많은 작업이 실행되면 렌더링이 느려질 수 있습니다. 따라서 보통은 ```useEffect```를 기본적으로 사용하고, 화면에 영향을 주는 작업만 ```useLayoutEffect```로 처리하는 것이 좋습니다. ## 📚 추가 학습 자료를 공유합니다. - [[F-Lab] React의 useEffect와 useLayoutEffect 이해하기](https://f-lab.kr/insight/understanding-useeffect-and-uselayouteffect-in-react-20240618?gad_source=1&gclid=Cj0KCQiAs5i8BhDmARIsAGE4xHxS3kYk36u3puO4sBg1VUM0jPwZPrMBYk7CUGUq3wzBdt6Md0nOxRcaAgVjEALw_wcB)

서론

사실…useLayoutEffect의 존재를 알게 된지는 얼마 안됐다. 예전에 GPT랑 싸우면서 트러블 슈팅하면서 처음 알게 됐는데, 그 때는 업무가 바빠서 제대로 공부하길 미루는 바람에 이번 주제에 대해서 제대로 얘기하지 못했다.
괜찮다. 그래서 지금 이 글을 쓰고 있는 거니까~~

정답

useEffect

먼저 useEffect는 React를 다루는 개발자라면 모르는 사람이 없을 것이다.
그러니 useEffect에 대한 개념을 다시 한 번 잡고 useLayoutEffect에 대해 알아보며 비교해볼 것이다.
공식문서에서는 useEffect를 다음과 같이 설명하고 있다.
외부 시스템과 컴포넌트를 동기화하는 React Hook
컴포넌트 내부의 로직은 크게 두 가지 유형으로 나눌 수 있다. 바로 렌더링 코드, 이벤트 핸들러이다.
  • 렌더링 코드는 props와 state를 적절히 변형해 결과적으로 JSX를 반환한다. 렌더링 코드의 로직은 순수하기 때문에 어떤 객체나 변수의 값을 변경(=Side Effect)하지 않는다.
  • 이벤트 핸들러는 사용자의 이벤트(버튼 클릭 또는 입력 등)에 따라 특정 동작을 수행하는 로직으로, Side Effect를 포함할 수 있으며 컴포넌트 내부의 중첩 함수 형태를 갖는다.
하지만 만약 사용자의 이벤트가 아니라 컴포넌트의 렌더링을 어느 동작의 트리거로 활용하고 싶은 경우는 어떻게 해야 할까?
여기서 useEffect를 활용할 수 있다. useEffect는 렌더링 자체에 의해 발생하는 부수효과를 특정한다. 즉, 이벤트 핸들러처럼 특정 이벤트에 대해서가 아닌, 렌더링에 의해 Side Effect를 수행할 수 있다.
여기까지가 useEffect의 기본 컨셉이다. 공식 문서에 나와있는 간단한 예시만 첨부하고, 사용법에 대한 디테일한 부분은 생략하도록 하겠다.
import { useState, useRef, useEffect } from 'react'; function VideoPlayer({ src, isPlaying }) { const ref = useRef(null); useEffect(() => { // VideoPlayer 컴포넌트가 렌더링될 때마다 다음의 로직이 수행된다. 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" /> </> ); }

useEffect와 useLayoutEffect

자 그럼 useLayoutEffect는 뭘까?
useEffect와 useLayoutEffect 모두 컴포넌트가 렌더링된 후 특정 작업을 수행하기 위해 사용된다는 점에서는 같다.
하지만 해당 작업을 수행하는 타이밍과 그 쓰임이 다르다.
useEffect는 렌더링이 완료된 시점에 비동기적으로 실행되는데, 화면이 실제로 사용자에게 그려진 후에 로직이 수행된다.
반면 useLayoutEffect는 렌더링 후 DOM이 업데이트되기 직전(=화면이 사용자에게 보여지기 전)에 동기적으로 실행된다.
프론트엔드 개발을 하다보면 useRef를 활용해 특정 DOM 요소의 크기 혹은 위치를 측정/조정해본 경험이 있을 것이다. 그런 경우 useEffect를 사용하면 동작 수행 후 DOM을 화면에 다시 그리게 되어 순간적으로 화면이 깜빡일 수 있다. 이 때 useEffect 대신 useLayoutEffect를 활용하면 해당 로직이 모두 끝난 후, 변경사항이 반영된 DOM이 화면에 출력되기 때문에 사용자 경험을 개선할 수 있다.
쓰임을 정리해보면 useEffect는 data fetch나 이벤트 리스너 추가처럼, 화면에 직접적인 영향을 주지 않는 작업에, useLayoutEffect는 DOM의 크기를 측정해서, 다른 요소의 위치를 조정해야 할 때 사용하는 것이 좋다.
한 가지 더 알아둬야할 주의사항은, useLayoutEffect는 동기적으로 실행되기 때문에 너무 많은 로직을 수행할 경우 렌더링이 느려질 수 있어 사용 시 트레이드 오프를 충분히 고려해야 한다.

(추가) useInsertionEffect

조사하다보니 비슷한 계열로 useInsertionEffect라는 훅이 있어 추가로 정리해보려고 한다. React 18 이상에서 지원되며, 스타일 삽입/계산 목적으로 설계된 훅으로, CSS-in-JS 라이브러리를 활용할 때 유용하게 쓰인다.
실행 시점은 DOM 변경 직후, 브라우저가 화면에 그릴 레이아웃을 계산하기 전에 수행된다. 시그니처는 나머지 두 훅과 동일하다.
앞선 두 가지 훅을 포함해 실행 순서를 정리하면 다음과 같다.
useInsertionEffect → useLayoutEffect → useEffect
React 렌더링 사이클에서의 순서를 정리하면 다음과 같이 정리할 수 있다.
  1. React가 DOM을 업데이트한다. (가상 DOM을 실제 DOM에 반영)
  1. useInsertionEffect 실행 (DOM 업데이트 후 브라우저가 레이아웃을 계산하기 전에 실행)
  1. useLayoutEffect 실행 (DOM 업데이트 후 브라우저가 화면을 그리기 전에 실행)
  1. 브라우저가 레이아웃을 계산하고 화면을 그리기 시작
  1. useEffect 실행 (비동기 후처리)
브라우저 렌더링 파이프라인에서의 Effect 훅 실행 시점
브라우저 렌더링 파이프라인에서의 Effect 훅 실행 시점

실습해보기

예제 코드는 jaddong님의 ‣ 글을 참고하여 만들었다. 좋은 글, 예제 제공에 감사드립니다!
import { Box, Button, Stack } from "@mui/material"; import { useEffect, useLayoutEffect, useState } from "react"; export default function App() { const [value, setValue] = useState(0); const [layoutValue, setLayoutValue] = useState(0); useEffect(() => { if (value === 0) { setValue(10 + Math.random() * 200); } }, [value]); useLayoutEffect(() => { if (layoutValue === 0) { setLayoutValue(10 + Math.random() * 200); } }, [layoutValue]); return ( <Stack p={2} gap={2}> <Stack direction="row" gap={1} alignItems={"center"}> <Button variant="outlined" onClick={() => setValue(0)}> 초기화 </Button> <Box width={200}>useEffect value</Box> {value} </Stack> <Stack direction="row" gap={1} alignItems={"center"}> <Button variant="outlined" onClick={() => setLayoutValue(0)}> 초기화 </Button> <Box width={200}>useLayoutEffect value</Box> {layoutValue} </Stack> </Stack> ); }
notion image
이게 gif 영상으로 찍으니까 프레임에 따라 깜빡임 현상이 잘 포착되지 않아서, useEffect value가 바뀌는 부분만 느리게 재생한 버전을 따로 만들었다.
notion image
보이는 것과 같이 useEffect value의 경우 다음과 같은 과정을 거치기 때문에, 순간적으로 0이 렌더링되는 현상이 발생한다.
  • 버튼 클릭
    • → layoutValue의 값이 0으로 초기화
      → 새 layoutValue의 값 0이 화면에 그려짐(Paint)
      → useEffect 실행
      → layoutValue의 값이 랜덤한 값으로 초기화
      → 새 layoutValue의 값(랜덤값)이 화면에 그려짐(Paint)
반면 useLayoutEffectValue의 경우 다음과 같은 과정을 거치므로, useEffect와 같은 깜빡임 현상 없이 자연스럽게 값이 변경되는 모습을 확인할 수 있다.
  • 버튼 클릭
    • → layoutValue의 값이 0으로 초기화
      → useLayoutEffect 실행
      → layoutValue의 값이 랜덤한 값으로 초기화
      → 새 layoutValue의 값(랜덤값)이 화면에 그려짐(Paint)
 
📚 일일 기술토크3 / 4
  1. 1편Q. 리액트에서 변수 관리 시 useRef를 사용하는 것은 let을 사용하는 것과 어떤 차이가 있나요?2025년 8월 17일
  2. 2편Q. tanstack-query에서 stale time과 gc time의 차이점에 대해서 설명해주세요2025년 8월 29일
  3. 3편useEffect와 useLayoutEffect의 차이점에 대해서 설명해주세요2025년 9월 14일
  4. 4편Q. 왜 기본 img 태그 대신 next/Image를 사용하셨나요?2025년 10월 31일