TypeScript type vs interface 객체 타입 설계 기준

type alias

type Task = {
  id: string;
  title: string;
  completed: boolean;
};

type은 객체뿐 아니라 다양한 타입 표현에 사용할 수 있습니다.

type TaskFilter =
  | 'all'
  | 'active'
  | 'completed';

union, tuple, conditional type 등 폭넓게 사용할 수 있습니다.

interface

interface Task {
  id: string;
  title: string;
  completed: boolean;
}

객체 구조를 표현할 때 읽기 쉽습니다.

확장

interface:

interface BaseTask {
  id: string;
  title: string;
}


interface Task
  extends BaseTask {
  completed: boolean;
}

type:

type BaseTask = {
  id: string;
  title: string;
};


type Task =
  BaseTask & {
    completed: boolean;
  };

둘 다 확장할 수 있습니다.

union

interface 자체를 union으로 선언할 수는 없습니다.

type Status =
  | 'idle'
  | 'loading'
  | 'success'
  | 'error';

이런 경우 type이 자연스럽습니다.

declaration merging

interface는 같은 이름으로 여러 선언이 있을 때 병합될 수 있습니다.

interface Window {
  appVersion: string;
}


interface Window {
  userId: string;
}

라이브러리 타입 확장이나 전역 declaration augmentation에서 유용할 수 있습니다.

일반 애플리케이션 도메인 모델에서는 의도치 않은 병합이 필요하지 않은 경우도 많습니다.

객체 타입 선택 기준

객체 타입뿐 아니라 union·Utility Type까지 같은 문법으로 관리하려면 type alias 중심으로 작성할 수 있습니다.

이유는 다음과 같습니다.

• TaskFilter 같은 union과 함께 사용
• Utility Type, mapped type과 연결
• 한 문서에서 타입 표현 방식을 통일
• 객체 외 타입도 같은 문법으로 관리

하지만 외부 라이브러리 declaration 확장이나 공개 interface가 더 자연스러운 상황에서는 interface를 사용할 수 있습니다.

잘못된 논쟁

다음처럼 절대 규칙으로 외울 필요는 없습니다.

객체면 interface
나머지는 type

또는:

무조건 type만 사용

프로젝트에서 실제로 필요한 기능을 확인합니다.

독립 예제

type UserRole =
  | 'admin'
  | 'member';


type User = {
  id: string;
  name: string;
  role: UserRole;
};


interface ApiError {
  message: string;
  status: number;
}

한 프로젝트에서 type과 interface를 함께 사용할 수도 있습니다.

중요한 것은 역할이 명확한가입니다.

객체가 같아 보인다고 확장 방식의 충돌 처리까지 같은 것은 아닙니다. interface 확장의 속성 충돌은 선언에서 드러나고, intersection은 양쪽 조건을 동시에 요구해 속성 타입이 never가 될 수 있습니다. 충돌을 해결할 때 두 선언을 기계적으로 서로 바꾸지 않습니다.

원리 확인: TypeScript type과 interface 선택 기준 (2026-10-12). 아래 기대 결과와 기존 실행 기록은 구분해서 읽습니다.

학습 완료 체크리스트

같은 Task 객체를 두 방식으로 검사한 뒤 TaskFilter union에는 무엇을 사용할지 정해 보세요. 이름을 바꾸는 취향과 선언 병합·union 같은 기능 요구를 구분해 선택 이유를 말할 수 있어야 합니다.