如何将 unknown 类型指定为一个更具体的类型?
参考答案
三种手段
- **类型断言
as**(你确信结构,最直接)
const u: unknown = JSON.parse('{"id":1,"name":"a"}');
interface User { id: number; name: string }
const user = u as User;
- 类型守卫(运行时校验 + 编译期收窄,推荐)
function isUser(x: unknown): x is User {
return typeof x === 'object' && x !== null
&& typeof (x as User).id === 'number'
&& typeof (x as User).name === 'string';
}
const data: unknown = JSON.parse(raw);
if (isUser(data)) {
data.name; // ✅ 已是 User
}
- 模式匹配式收窄(
in/typeof/instanceof/ 判别字段)
if (typeof u === 'string') { /* string */ }
else if (Array.isArray(u)) { /* any[] */ }
else if (u && typeof u === 'object' && 'id' in u) { /* 有 id 的对象 */ }
工程化方案
- 运行时 schema 校验库:zod、io-ts、valibot、class-validator,校验通过后由
z.infer自动得到类型,最稳。
const UserSchema = z.object({ id: z.number(), name: z.string() });
type User = z.infer<typeof UserSchema>;
const user = UserSchema.parse(unknownData); // 校验失败会抛错
- 类型断言函数:
function assertUser(x: unknown): asserts x is User { ... },调用后整个作用域收窄。
注意
as只是编译期告诉编译器"相信我",运行时不做任何检查;数据不对会静默出错,只适合已确定可信的场景(如刚校验过)。- **不要用双重断言
as unknown as T** 绕过错误,那等于放弃类型安全。 - 收窄后仍要在边界处校验(API、
localStorage、postMessage、JSON.parse),一次校验、内部放心。 as const是另一回事(保留字面量类型),不要混淆。