TS中 unknown 和 any 的区别

any 类型

any 是 TypeScript 中最宽松的类型，它表示"任何类型"：

js 复制代码

let value: any = 42;
value = "hello";
value = true;
value = { name: "John" };
value = [1, 2, 3];

// 可以直接访问属性和方法，不会报错
console.log(value.name); // 运行时可能出错，但编译时不会报错
value.someMethod(); // 编译时不会报错

特点：

关闭了 TypeScript 的类型检查

可以赋值给任何类型

可以访问任何属性和方法

失去了类型安全的保护

unknown 类型

unknown 是 TypeScript 3.0 引入的类型，表示"未知类型"：

js 复制代码

let value: unknown = 42;
value = "hello";
value = true;
value = { name: "John" };

// 不能直接访问属性和方法，会报错
console.log(value.name); // ❌ 编译错误
value.someMethod(); // ❌ 编译错误

// 需要先进行类型检查
if (typeof value === 'string') {
  console.log(value.toUpperCase()); // ✅ 安全
}

if (value && typeof value === 'object' && 'name' in value) {
  console.log((value as { name: string }).name); // ✅ 安全

特点：

保持类型安全

不能直接赋值给其他类型（除了 any 和 unknown）

不能直接访问属性和方法

需要类型检查或类型断言才能使用

实际应用对比

使用 any 的问题

js 复制代码

function processData(data: any) {
  // 这些操作在编译时都不会报错，但运行时可能出错
  return data.name.toUpperCase() + data.age.toString();
}

const result = processData({ name: "John", age: 30 }); // ✅ 正常
const result2 = processData({ name: "John" }); // ❌ 运行时错误：age is undefined
const result3 = processData("hello"); // ❌ 运行时错误：name is undefined

使用 unknown 的安全做法

js 复制代码

function processData(data: unknown) {
// 需要先检查类型
if (data && typeof data === 'object' && 'name' in data && 'age' in data) {
 const user = data as { name: string; age: number };
 return user.name.toUpperCase() + user.age.toString();
}
throw new Error('Invalid data format');
}

// 或者使用类型守卫
function isUser(data: unknown): data is { name: string; age: number } {
return data !== null && 
      typeof data === 'object' && 
      'name' in data && 
      'age' in data &&
      typeof (data as any).name === 'string' &&
      typeof (data as any).age === 'number';
}

function processDataSafe(data: unknown) {
if (isUser(data)) {
 // 这里 TypeScript 知道 data 的类型
 return data.name.toUpperCase() + data.age.toString();
}
throw new Error('Invalid data format');
}

为什么使用 unknown：

类型安全：强制调用者进行类型检查

更好的错误提示：如果使用不当，编译时就会报错

渐进式类型化：可以逐步添加更具体的类型

总结

特性	any	unknown
类型安全	❌ 无	✅ 有
可赋值给其他类型	✅ 是	❌ 否（需要类型检查）
可访问属性/方法	✅ 是	❌ 否（需要类型检查）
编译时检查	❌ 无	✅ 有
推荐使用	❌ 尽量避免	✅ 推荐

建议：

优先使用 unknown，它提供更好的类型安全

只有在确实需要绕过类型检查时才使用 any

对于 API 响应等不确定类型的数据，使用 unknown 然后进行类型检查