TypeScript 7 전환 기준 TS6 차이와 deprecated tsconfig 정리

TypeScript 7의 핵심 변화

공식 확인: TypeScript 7.0 정식 발표를 2026-09-28에 확인했습니다. 네이티브 tsc와 기존 compiler API 호환 도구는 별도로 점검합니다.

TypeScript 7은 Go 기반 네이티브 compiler와 language service를 사용합니다.

공식 발표 기준으로 full build에서 일반적으로 큰 성능 향상을 목표로 하며, 기존 TypeScript 6과 타입 검사 결과를 가능한 한 일치시키도록 포팅되었습니다.

일반 사용자 입장에서는 여전히 다음 package와 command를 사용합니다.

npm install -D typescript
npx tsc --version
npx tsc --noEmit

TypeScript 6과의 관계

TypeScript 7은 TypeScript 6의 type-checking과 command-line 동작을 기준으로 호환성을 맞추는 방향입니다.

따라서 5.x 프로젝트에서 바로 7로 올라가는 것보다 TypeScript 6에서 deprecation을 먼저 해결하는 흐름이 더 안전할 수 있습니다.

특히 TypeScript 6에서 deprecated된 옵션은 TypeScript 7에서 hard error가 될 수 있습니다.

주요 기본값 변화

TypeScript 7에서 알아둘 기본 방향은 다음과 같습니다.

strict
→ true 기본


module
→ esnext 기본


target
→ esnext 직전의 최신 안정 ECMAScript


noUncheckedSideEffectImports
→ true 기본


types
→ [] 기본


rootDir
→ ./ 기본

기존 프로젝트가 특정 global @types package를 자동으로 기대했다면 types 변화가 영향을 줄 수 있습니다.

예:

{
  "compilerOptions": {
    "types": [
      "node",
      "vitest/globals"
    ]
  }
}

실제로 필요한 global type만 명시합니다.

rootDir 확인

TypeScript 7에서는 rootDir 기본값 변화 때문에 기존 output 구조가 달라질 수 있습니다.

src 아래를 명확한 source root로 사용한다면:

{
  "compilerOptions": {
    "rootDir": "./src"
  },
  "include": [
    "./src"
  ]
}

처럼 명시할 수 있습니다.

Vite 프로젝트에서 emit을 TypeScript가 직접 담당하지 않는다면 실제 build pipeline과 함께 확인합니다.

target: es5 제거

TypeScript 7에서는 ES5 target이 더 이상 지원되지 않습니다.

오래된 프로젝트에서 다음 설정을 사용하면 migration이 필요합니다.

{
  "compilerOptions": {
    "target": "es5"
  }
}

현대적인 frontend build에서는 Vite/Babel/browser target 전략과 함께 최신 ECMAScript target을 사용합니다.

moduleResolution node / node10 제거

오래된 설정:

{
  "compilerOptions": {
    "moduleResolution": "node"
  }
}

또는 node10은 TypeScript 7에서 지원되지 않습니다.

bundler 환경:

{
  "compilerOptions": {
    "moduleResolution": "bundler"
  }
}

Node.js ESM 프로젝트:

{
  "compilerOptions": {
    "moduleResolution": "nodenext"
  }
}

실행 환경에 따라 선택합니다.

classic 제거

{
  "compilerOptions": {
    "moduleResolution": "classic"
  }
}

이전 방식은 제거되었습니다.

새 프로젝트 예제에 사용하지 않습니다.

baseUrl 제거

TypeScript 7에서는 baseUrl 설정이 더 이상 지원되지 않습니다.

이전:

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": [
        "src/*"
      ]
    }
  }
}

현재는 paths target을 프로젝트 root 기준 상대 경로로 정리하는 방향을 사용합니다.

{
  "compilerOptions": {
    "paths": {
      "@/*": [
        "./src/*"
      ]
    }
  }
}

실제 bundler의 alias 설정도 함께 맞춰야 합니다.

module 옵션 제거 항목

다음 legacy module 방식은 TypeScript 7에서 지원되지 않습니다.

amd
umd
systemjs
none

bundler를 사용하는 frontend에서는 esnext 또는 preserve 계열이 더 자연스럽습니다.

esModuleInterop 관련 변화

TypeScript 7에서는 esModuleInterop과 allowSyntheticDefaultImports를 false로 설정할 수 없습니다.

오래된 프로젝트에서 명시적으로 false를 사용했다면 설정을 제거하거나 migration합니다.

alwaysStrict

strict mode는 기본적으로 가정되므로 alwaysStrict를 false로 끄는 방식은 지원되지 않습니다.

command line file path 주의

현재 directory에 tsconfig.json이 있을 때 command line에서 파일 path를 직접 넘기는 기존 습관은 TypeScript 7에서 제한됩니다.

프로젝트 단위로 실행합니다.

npx tsc --noEmit

특정 config:

npx tsc \
  -p tsconfig.app.json

compiler API 호환성

TypeScript 7 초기 버전은 기존 TypeScript JavaScript compiler API와 완전히 동일한 programmatic API를 제공하지 않는 부분이 있습니다.

일부 tool이 기존 typescript package의 compiler API에 직접 의존하면 TypeScript 6 compatibility package가 필요할 수 있습니다.

공식 migration 방식 중 하나:

npm install -D \
  typescript@npm:@typescript/typescript6

이 경우 TypeScript 6 compatibility compiler를 사용하게 됩니다.

TypeScript 7의 tsc도 함께 필요하면 package alias를 별도로 둘 수 있습니다.

{
  "devDependencies": {
    "@typescript/native": "npm:typescript@^7.0.2",
    "typescript": "npm:@typescript/typescript6@^6.0.2"
  }
}

일반 Vite 애플리케이션에서는 먼저 현재 도구들이 TypeScript 7을 지원하는지 확인하고, 실제 compiler API 문제가 있을 때만 compatibility 구성을 사용합니다.

업그레이드 순서

1. 현재 TypeScript 버전 확인
2. TypeScript 6 deprecation warning 확인
3. deprecated tsconfig option 제거
4. moduleResolution 정리
5. baseUrl 제거
6. rootDir / types 기본값 영향 확인
7. npx tsc --noEmit
8. npm run build
9. test 실행
10. editor TypeScript version 확인

오래된 tsconfig를 그대로 유지하지 않기

다음처럼 역사적으로 쌓인 옵션이 많다면 각 옵션이 현재 필요한지 확인합니다.

{
  "compilerOptions": {
    "target": "es5",
    "moduleResolution": "node",
    "baseUrl": ".",
    "downlevelIteration": true,
    "alwaysStrict": false
  }
}

TypeScript 7에서는 제거되었거나 지원 방향이 바뀐 항목이 포함되어 있습니다.

설정을 단순화합니다.

설정 오류가 사라졌다는 사실만으로 업그레이드를 끝내지 않습니다. 같은 소스의 타입 검사, JavaScript 출력·번들 경로, compiler API를 사용하는 도구를 따로 확인해야 기존 동작이 유지되는지 판단할 수 있습니다.

원리 확인: TypeScript 7.0 공식 전환 안내 (2026-10-12). 아래 기대 결과와 기존 실행 기록은 구분해서 읽습니다.

학습 완료 체크리스트

자기 프로젝트에서 없어도 되는 설정 하나와 명시해야 할 설정 하나를 고르고 이유를 설명해 보세요. 예를 들어 삭제된 baseUrl과 출력 경로를 유지하는 rootDir은 서로 다른 판단입니다.