剛學 TypeScript 時經常困惑：interface 和 type 都能定義類型，什麼時候用哪個？

相似之處

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

// type alias
type User = {
  id: number;
  name: string;
};

// 兩者都可以：
// - 描述對象結構
// - 可選屬性 ?
// - 只讀屬性 readonly
// - 被 class implements
// - 互相 extends/交叉

核心區別

1. interface 可以聲明合併（Declaration Merging）

interface Window {
  myProp: string;
}
interface Window {
  anotherProp: number;
}
// 自動合併為：{ myProp: string; anotherProp: number }

// type 不能重複聲明：
type Foo = { a: string };
type Foo = { b: number }; // ❌ 報錯：重複聲明

這對擴展全局類型（如 Window、Vue）很有用。

2. type 能表示更多類型

// 聯合類型（interface 做不到）
type Status = "pending" | "success" | "error";
type ID = number | string;

// 元組
type Point = [number, number];

// 條件類型（interface 做不到）
type NonNullable<T> = T extends null | undefined ? never : T;

// 映射類型（interface 可以，但 type 更常見）
type Optional<T> = { [K in keyof T]?: T[K] };

// 函數類型（兩種都行，type 更簡潔）
type Handler = (event: MouseEvent) => void;
interface Handler {
  (event: MouseEvent): void;
}

3. extends 語法

// interface 繼承：
interface Animal { name: string }
interface Dog extends Animal { breed: string }

// type 繼承（用交叉類型）：
type Animal = { name: string }
type Dog = Animal & { breed: string }

// interface 和 type 可以互相 extends：
interface A extends type B { ... }  // ✅
type C = interface D & { ... }      // ✅（通過交叉類型）

推薦實踐

用 interface 的場景：

• 描述對象/類的結構（語義更清晰）
• 需要聲明合併時（擴展第三方類型）
• 公共 API（便於使用方擴展）

用 type 的場景：

• 聯合類型、元組
• 工具類型（Conditional Types、Mapped Types）
• 函數類型（可讀性稍好）

// 實際項目的規範
// 描述數據結構 → interface
interface User {
  id: number;
  name: string;
}
interface ApiResponse<T> {
  code: number;
  data: T;
}

// 工具類型 → type
type Nullable<T> = T | null;
type Optional<T> = { [K in keyof T]?: T[K] };

// 聯合類型 → type
type ButtonVariant = "primary" | "secondary" | "ghost";
type RequestStatus = "idle" | "loading" | "success" | "error";

小結

• interface 和 type 大多數場景可以互換
• interface 支持聲明合併，適合描述對象結構和公共 API
• type 更靈活，支持聯合類型、條件類型等
• 團隊統一規範比糾結哪個更好更重要