TypeScript 接口类型检查：常见问题与解答

引言：为什么接口在运行时不起作用？

朋友，你好！如果你写过 TypeScript，很可能遇到过这种情况：你创建了一个完美的接口，描述了所有字段，在编译时检查了类型——然后突然发现，在运行时，你的代码表现得好像接口根本不存在。听起来很熟悉吧？🎯

这是 Stack Overflow 上最热门的问题之一："TypeScript 接口类型检查"——成千上万的浏览量，成百上千的答案。这并不奇怪，因为 TypeScript 在编译期间会擦除接口。与类不同，接口纯粹是为开发者和编译器提供的声明性构造。它们在 JavaScript 中不存在。

在本文中，我们将弄清楚如何绕过这个限制，学习如何在运行时检查对象是否符合接口，并回答最常见的问题。开始吧！🚀

为什么我们想要检查接口？

想象一下：你从 API、表单或 WebSocket 接收数据。你确信它符合 User 接口，但突然一个对象到达，缺少了 email 字段或者类型错误。如果你不检查——你的代码会因为错误而崩溃。TypeScript 接口仅在开发期间检查，而不是在生产环境中。因此，运行时检查是必要的。

问题：接口在运行时不存在

在 TypeScript 中，接口是静态类型的"语法糖"。当你编译代码时，接口会消失。这里有一个简单的例子：

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

const data: unknown = JSON.parse('{"name": "Alice"}');
if (data instanceof User) { // ❌ 错误！User 是一个接口，而不是一个类
  console.log(data.name);
}

编译器会说：'User' 仅指一种类型，但在此处被用作一个值。这是初学者的主要陷阱。但别担心——有几种行之有效的方法可以绕过它。

方法 1：用户定义的类型保护

最流行且优雅的方法是编写一个类型保护函数。它检查对象的结构并返回 true/false，TypeScript 会"理解"在 true 的代码块内，该对象肯定符合接口。

interface User {
  name: string;
  age: number;
  email?: string; // 可选字段
}

function isUser(obj: unknown): obj is User {
  if (typeof obj !== 'object' || obj === null) return false;

  const user = obj as Record<string, unknown>;
  return (
    typeof user.name === 'string' &&
    typeof user.age === 'number' &&
    (user.email === undefined || typeof user.email === 'string')
  );
}

// 使用示例
const data: unknown = JSON.parse('{"name": "Bob", "age": 30}');

if (isUser(data)) {
  // 现在 TypeScript 知道 data 是一个 User
  console.log(data.name.toUpperCase()); // ✅ 生效
}

优点：完全控制，类型被正确推断，易于扩展。
缺点：需要为每个接口手动编写（但有一些库可以帮忙！）

什么是 obj is User？

这是类型保护的语法。它告诉 TypeScript："如果函数返回 true，那么参数 obj 可以被视为 User 类型"。这就是使运行时检查对静态分析有用的魔法。

方法 2：使用类而不是接口

类是唯一在 JavaScript 中持久存在的 TypeScript 构造。如果你需要在运行时检查类型，你可以用类替换接口，并使用 instanceof 进行检查。

class User {
  constructor(
    public name: string,
    public age: number,
    public email?: string
  ) {}
}

const data = new User('Charlie', 25);
if (data instanceof User) {
  consol