やあ。現場でコードを書いていて、「結局 `interface` と `type` ってどっちを使えばいいの？」と迷ったことはないか？
正直に言おう。この問いには「唯一絶対の正解」はない。しかし、「なぜその設計にしたのか」という根拠が言えないのはプロとして避けるべきだ。
今日は、TypeScriptの荒波を乗りこなすために必要な、この二つの使い分けの「極意」を授けよう。
—
1. そもそもTypeScriptが裏でやっていること
まず前提として、TypeScriptの型システムは「静的解析」のためにある。ブラウザ（JavaScriptエンジン）は型なんて1ミリも解釈していない。コンパイル（トランスパイル）の過程で、これらの型情報は跡形もなく消え去るんだ。
だからこそ、型定義は「実行時の動作」ではなく、「開発者がコードをどう読み、どう拡張しやすくするか」という設計思想のメタデータとして考えるべきなんだよ。
—
2. interface と type の決定的な分岐点
宣言の結合（Declaration Merging）
`interface` の最大の武器はこれだ。同じ名前で定義を分けると、勝手にマージしてくれる。
// 外部ライブラリの型定義を拡張したい時などに最強
interface User {
id: number;
}
interface User {
name: string;
}
// コンパイルすると { id: number; name: string; } になる
const user: User = { id: 1, name: “Taro” };
これはライブラリの型を拡張したり、モジュールごとに定義を分割したい時に劇的な威力を発揮する。`type` にはこれができない。
表現力の違い
一方で `type` は、「型エイリアス」という名の通り、既存の型に名前をつけたり、ユニオン型（`|`）やインターセクション（`&`）を駆使して柔軟な表現ができる。
// typeでしかできないこと（ユニオン型）
type Status = “pending” | “success” | “error”;
// タプル型との相性も抜群
type Point = [number, number];
// インターセクションも直感的
type Admin = User & { role: ‘admin’ };
—
3. 実務で迷わないための「使い分けの指針」
現場のシニアエンジニアとして、俺は以下のような基準でチームにガイドラインを引いている。
1. 基本は `interface` を使う
- オブジェクトの型定義は、基本的に `interface` を優先する。エラーメッセージが親切で、パフォーマンス的にもコンパイラの最適化が効きやすい（型チェックが遅延評価されることが多いからだ）。
2. `type` は「複雑な型」が必要な時に使う
- ユニオン型、タプル、マッピング型、あるいは関数のシグネチャなど、`interface` では表現しきれない「柔軟性」が必要な時は迷わず `type` を選ぶ。
3. 拡張性が必要なら `interface`
- プロジェクトの成長とともに後からプロパティを足す可能性があるなら、`interface` の宣言結合に頼るのがスマートだ。
—
4. コピペで使える！実践的な設計パターン
最後に、現場でよく使う「型定義の構成」を提示しよう。
/
- 1. 基本的なデータ構造は interface で定義
/
interface BaseUser {
id: string;
email: string;
}
/
- 2. 型の合成には type を使う（柔軟性が高い）
/
type UserWithProfile = BaseUser & {
bio: string;
avatarUrl: string;
};
/
- 3. 状態の管理には type のユニオン型を活用
/
type AuthStatus = “unauthorized” | “loading” | “authorized”;
// 実践例：関数での利用
function renderUser(user: UserWithProfile, status: AuthStatus) {
if (status === “loading”) return “読み込み中…”;
return `こんにちは、${user.email}さん！`;
}
// ちなみに、タプル型を使うと引数の固定にも使える
type Coordinates = [number, number];
const myLoc: Coordinates = [35.68, 139.76];
—
最後に：あまり深く考えすぎるな
「`interface` か `type` か」に時間を使いすぎて、本来のビジネスロジックに集中できなくなるのは本末転倒だ。
迷ったらこう考えろ。
「まずは `interface` で書いてみる。困ったら `type` に書き換える」。これだけで十分だ。TypeScriptの神は、細部の型定義よりも「コードのメンテナンス性」を重視するエンジニアに微笑むからな。
また何か壁にぶつかったら、いつでも聞きに来てくれ。プロの現場は、こうやって一つずつ知見を積み上げていくものさ。頑張れよ。
コメント