Fix: Restore unified Topics folder and reorganize specialized category folders

This commit is contained in:
Antigravity Agent
2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,42 @@
---
id: p5e4r3f2-a1b2-4c3d-8e9f-0a1b2c3d4e5f
category: Dev
confidence_score: 0.99
tags: [performance, memory-leak, debugging, optimization, react, devtools, core-web-vitals]
last_reinforced: 2026-05-01
github_commit: "wikification-performance-memory"
---
# Frontend Performance & Memory Management
## 📌 한 줄 통찰 (The Karpathy Summary)
> 프론트엔드 성능 최적화는 단순히 렌더링을 줄이는 것이 아니라, 사용자 체감 성능(LCP, CLS, FID)을 개선하고 크롬 개발자 도구 및 프로파일러를 통해 메모리 누수와 메인 스레드 점유율을 정밀하게 타격하는 엔지니어링이다.
## 📖 구조화된 지식 (Synthesized Content)
### 1. 런타임 성능 및 리렌더링 최적화
- **메모이제이션**: `React.memo`, `useMemo`, `useCallback`을 적재적소에 배치하여 불필요한 가상 DOM 연산을 방지한다.
- **Concurrent Mode**: React 18의 `useTransition`, `useDeferredValue`를 활용하여 우선순위가 낮은 업데이트를 뒤로 미룸으로써 UI 반응성을 유지한다.
- **Code Splitting**: `React.lazy`와 동적 임포트를 통해 초기 번들 크기를 줄이고 필요한 시점에 코드를 로드한다.
### 2. 메모리 관리 및 누수 탐지
- **메모리 누수 유형**: 전역 변수 남용, 해제되지 않은 타이머/이벤트 리스너, 클로저에 의한 참조 유지, **Detached DOM Nodes** 등이 주요 원인이다.
- **Heap Snapshot**: 크롬 개발자 도구의 Memory 탭을 통해 힙 스냅샷을 비교하고, 객체가 의도치 않게 메모리에 남아 있는지 확인한다.
### 3. 디버깅 및 분석 도구
- **React DevTools Profiler**: 컴포넌트별 렌더링 시간과 원인을 파악하여 병목 지점을 찾는다.
- **Lighthouse & Core Web Vitals**: LCP(최대 콘텐츠 페인트), CLS(누적 레이아웃 이동), INP(다음 상호작용에 대한 응답) 지표를 측정하고 최적화한다.
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- **무분별한 메모이제이션**: 모든 곳에 `useMemo`를 쓰는 것은 오히려 메모리 점유율을 높이고 얕은 비교 비용을 발생시킨다. 측정(Profiling) 후 적용하는 것이 원칙이다.
- **가비지 컬렉션의 한계**: JS는 자동 GC를 지원하지만, 개발자가 참조 고리(Reference chain)를 끊어주지 않으면 GC는 이를 회수할 수 없다.
## 🔗 지식 연결 (Graph)
- **Parent**: 10_Wiki/Topics/Development
- **Related**: [[Vite Build System|Vite Build System]], Zustand, [[React Compiler|React Compiler]]
- **Raw Source**: 00_Raw/웹 성능 최적화(Core Web Vitals) 개선 작업, 00_Raw/Vite + React 성능 최적화, 00_Raw/Frontend Performance Debugging, 00_Raw/JavaScript Memory Management, 00_Raw/Memory Leak Detection, 00_Raw/Detached DOM Nodes
## 💻 GitHub 동기화 자동화 워크플로우
1. Stage: git add .
2. Commit: `git commit -m "[P-Reinforce] Wikify Frontend Performance and Memory Management Guide"`
3. Push: `git push origin main`