skipLibCheck 및 격리된 선언

skipLibCheck란 무엇입니까

// tsconfig.json
{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

skipLibCheck를 사용하는 경우

// Common scenario: two libraries ship conflicting .d.ts
// skipLibCheck: true silences those errors so you can focus on your code

skipLibCheck의 위험

// Risk: incorrect .d.ts in a library goes undetected
// Mitigation: enable skipLibCheck only for known-safe packages

skipDefaultLibCheck

{
  "compilerOptions": {
    "skipDefaultLibCheck": true
    // Third-party .d.ts files still checked
  }
}

격리된 선언이란 무엇입니까

// tsconfig.json
{
  "compilerOptions": {
    "isolatedDeclarations": true
  }
}

isolatedDeclarations가 작업 속도를 높이는 이유

// Without isolatedDeclarations:
// File A's .d.ts requires type-checking File B's return type first.
// With isolatedDeclarations:
// Each file's .d.ts generated from its explicit annotations alone.

오류: 반환 타입 주석 누락

// Error with isolatedDeclarations: true
export function getUser(id: string) { return fetchUser(id); }

// Fix: add explicit return type
export function getUser(id: string): Promise<User> { return fetchUser(id); }

isolatedDeclarations와 DTS 번들러

# oxc with isolatedDeclarations for fast .d.ts generation
npx oxc-transform ./src --declarations

두 옵션 함께 사용하기

{
  "compilerOptions": {
    "skipLibCheck": true,
    "isolatedDeclarations": true
  }
}

마이그레이션 경로

# ESLint rule to auto-add return types:
# @typescript-eslint/explicit-function-return-type

skipLibCheck와 격리된 선언 요약

빠른 확인

배운 내용