느린 TypeScript 컴파일 프로파일링

TypeScript가 느려질 수 있는 이유

// Expensive: distributive conditional on large union
type Slow = LargeUnion extends infer T ? T extends string ? T : never : never;

--extendedDiagnostics 플래그

tsc --extendedDiagnostics 2>&1 | head -40
# Output:
# Files:             212
# Lines:            48320
# Check time:       8.23s  ← focus here

--generateTrace 플래그

tsc --generateTrace ./trace-output
# Open trace-output/trace.json in Chrome DevTools > Performance

추적 분석하기

# Common culprits in traces:
# - Recursive mapped types with large inputs
# - Distributive conditionals over 50+ member unions
# - Deep infer chains on complex generics

--listFiles 플래그

tsc --listFiles 2>&1 | grep node_modules | wc -l
# If this is large, check your include/exclude settings

파일 포함 줄이기

{
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "**/*.test.ts"]
}

빠른 개선을 위한 skipLibCheck

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

처리 비용이 큰 타입 격리하기

// Slow: recomputed at each usage
type Result = ComplexUnion extends string ? ComplexUnion : never;

// Fast: cached
type FilteredUnion = ComplexUnion extends string ? ComplexUnion : never;
type Result = FilteredUnion;

transpileOnly로 검사하기

// jest.config.js with ts-jest
{
  transform: {
    "^.+\.tsx?$": ["ts-jest", { diagnostics: false }]
  }
}

편집기 성능

// VS Code settings.json to enable detailed TS server log:
// "typescript.tsserver.log": "verbose"

컴파일 성능 분석 요약

빠른 확인

배운 내용