Interface frente a Type: cuándo usar cada uno

Bienvenida

Similitudes

interface A { x: number; }
type B = { x: number; };
// Both describe the same shape

Diferencia clave: fusión de declaraciones

interface Config { host: string; }
interface Config { port: number; } // OK — merged

type Settings = { host: string; };
// type Settings = { port: number; }; // Error

Diferencia clave: unión e intersección

type ID = string | number;        // union — only with type
type Nullable<T> = T | null;       // union — only with type
type Point = [number, number];     // tuple — only with type

Diferencia clave: propiedades calculadas

type ReadonlyUser = Readonly<{ name: string; age: number }>; // mapped type
type Keys = keyof User; // only with type

Uso de interface para contratos de clases

interface Repository<T> {
  findById(id: number): T | null;
  save(item: T): void;
}
class UserRepo implements Repository<User> { /* ... */ }

Rendimiento: interfaces frente a tipos

Diferencias en los mensajes de error

Recomendación oficial de TypeScript

La coherencia del equipo es lo más importante

Tabla de decisión resumida

// interface
interface User { name: string; age: number; }

// type (union)
type ID = string | number;

// type (tuple)
type Coord = [number, number];

Comprobación rápida

Resumen