Initial Commit: Reinforced Knowledge Wiki v1.0 - Pure Origin

01_Archive/2026-04-20/React 19 Compiler의 Three.js 런타임 성능 개선 원리.md

@@ -0,0 +1,25 @@
+
+
+## 📌 Brief Summary
+
+React 19 컴파일러는 빌드 타임에 코드의 값, 컴포넌트, 콜백 함수를 자동으로 메모이제이션하여 잦은 가비지 컬렉션(GC)과 불필요한 리렌더링을 차단함으로써, React Three Fiber(R3F) 기반 3D 게임의 프레임 레이트(FPS)를 안정화하고 런타임 성능을 획기적으로 개선합니다.
+
+## 📖 Core Content
+
+**1. 자동 참조 안정성(Reference Stability) 확보를 통한 리렌더링 방지** React 환경에서는 부모 컴포넌트의 상태가 변할 때마다 하위 컴포넌트들이 기본적으로 모두 리렌더링됩니다. 특히 인라인 함수나 객체가 매 렌더링마다 새로운 참조(Reference)를 생성하면, 하위에 있는 무거운 3D 컴포넌트(Mesh, Material 등)가 불필요하게 렌더링을 반복하게 됩니다. React 19 컴파일러는 `useMemo`나 `useCallback` 없이도 안전한 모든 곳에 메모이제이션을 자동 적용하여 참조 안정성을 확보해 주므로, 무거운 3D 객체의 무의미한 재생성을 막아줍니다.
+
+**2. 가비지 컬렉션(GC) 스파이크 억제** 실시간 3D 게임에서 가장 치명적인 성능 저하 원인 중 하나는 단기간에 수많은 객체가 생성되고 버려지면서 발생하는 가비지 컬렉션 멈춤(Stop-the-world) 현상입니다. 컴파일러가 연산 결과와 콜백 함수를 자동으로 캐싱하면 렌더링마다 버려지는 객체의 생성이 크게 줄어들어, 메모리 파편화 및 GC로 인한 프레임 드랍(Lag)을 효과적으로 억제할 수 있습니다.
+
+**3. 재조정(Reconciliation) 오버헤드 감소로 메인 스레드 확보** React의 가상 DOM 트리를 비교하는 재조정(Reconciliation) 과정은 CPU 연산 비용이 높습니다. 컴파일러 적용 시 순수 컴포넌트의 90% 이상, 연산 값의 85% 이상이 자동으로 캐싱되어 렌더링 소요 시간이 단축됩니다. 덕분에 메인 스레드의 부하가 줄어들어, 게임 루프가 물리 엔진 연산이나 렌더링 로직 처리에 더 많은 자원을 온전히 사용할 수 있게 됩니다.
+
+**4. 수동 최적화의 한계 및 휴먼 에러 극복** 과거에는 복잡한 3D 씬을 구성할 때 개발자가 직접 모든 의존성 배열을 관리하며 수동으로 메모이제이션을 해야 했고, 이 과정에서 실수가 발생하기 쉬웠습니다. 컴파일러는 이러한 보일러플레이트 코드를 제거하고 빌드 타임에 최적화를 보장하므로, 개발자는 미세한 메모이제이션에 신경 쓰는 대신 Three.js 씬 그래프 최적화 등 근본적인 엔진 아키텍처에 더 집중할 수 있습니다.
+
+## 🔗 Knowledge Connections
+
+- **Related Topics:** [[React 19 Compiler]], [[React Three Fiber (R3F)]], [[가비지 컬렉션(GC) 최적화]], [[불필요한 리렌더링 방지]]
+- **Projects/Contexts:** [[고성능 실시간 상호작용 시스템을 위한 React 기반 게임 엔진 아키텍처]]
+- **Contradictions/Notes:** React 19 컴파일러가 선언적 UI의 리렌더링 성능을 비약적으로 높여주지만, 게임의 근본적인 안티 패턴까지 해결해 주지는 않습니다. 예를 들어, 매 프레임 실행되는 `useFrame` 루프 내부에서 React 상태(`setState`)를 업데이트하거나 객체를 새로 생성(`new Vector3()`)하는 것은 여전히 치명적입니다. 빈번하게 변하는 3D 객체의 위치나 회전값 등은 컴파일러에 의존할 것이 아니라, 반드시 참조(Ref)를 사용하여 직접 변형(Direct Mutation)해야 합니다.
+
+---
+
+_Last updated: 2026-04-15_