TypeScript 如何做类型断言函数
刚接触TypeScript的开发者，大多会被“类型”这个门槛绊住——明明代码逻辑没问题，却因为TS识别不了变量的类型，疯狂飘红报错。比如你从后端接口拉到数据，想直接用某个属性，TS偏会说“这个值可能是any类型，不能直接用”；或者处理用户上传的文件，你明明知道拿到的是个图片文件，TS却不认。这时候，类型断言函数就成了帮你“搞定TS”的实用工具，它不是真的改变变量的类型，只是“告诉TS，我确定这个值是什么类型”，既不破坏TS的类型安全，又能让代码顺顺利利跑起来。
先搞懂：普通类型断言和函数断言的区别
很多人刚学TS，最先接触的是“尖括号断言”，比如const name = (user as User).name;，或者“非空断言”value!，但这些写法有个小局限：只能用在当前代码里，不能复用。要是你在多个地方都要“确认某个变量是字符串”，每次都写一遍as string，既麻烦又容易写错。
而类型断言函数，就是把“断言类型”的逻辑封装成一个可复用的函数，专门用来帮TS判断“这个值是不是我想要的类型”，比普通断言灵活多了。举个生活化的例子：你快递到了，想确认是不是自己买的零食，普通断言是“我拿过来一看，哦，是我的零食”，只能用一次；类型断言函数就是你提前做了个“零食快递鉴定卡”，不管哪个快递到，你都能拿着卡对一遍，符合就收下，不符合就拒收，完全不用每次重新检查。
怎么写第一个类型断言函数？
写断言函数的核心，是用TS自带的is关键字——它能告诉TS：“这个函数返回true时，参数的类型就是我指定的那个”。
举个实际的场景：你有个接口返回的用户数据，TS里定义了User类型（有id和name属性），但接口偶尔会返回空对象{}，这时候就需要一个函数来确认“这个值是不是合法的User”：
`typescript
// 先定义好你需要的类型
interface User {
id: number;
name: string;
}
// 类型断言函数，参数是unknown类型（避免TS默认把任意值当成合法类型）
function isUser(value: unknown): value is User {
// 检查：value是对象、不是空、有number类型的id、有string类型的name
return (
typeof value === 'object' &&
value !== null &&
'id' in value && typeof (value as User).id === 'number' &&
'name' in value && typeof (value as User).name === 'string'
);
}
`
这里用unknown做参数类型，是为了更安全——如果直接用any，TS就失去了类型检查的意义，而unknown要求你必须先判断类型才能用，刚好契合断言函数的需求。
断言函数怎么用？
用法非常简单，只要在判断分支里调用它，TS就能自动推导类型了。比如你处理接口返回的数据：
`typescript
async function fetchUser() {
const res = await fetch('/api/user');
const data: unknown = await res.json(); // 接口返回的是unknown，不确定类型
// 用断言函数判断
if (isUser(data)) {
// 进入这个分支后，TS自动知道data是User类型，直接用属性不会报错
console.log(欢迎用户：${data.name});
return data;
} else {
console.error('获取用户信息失败');
return null;
}
}
`
是不是很方便？不管你要判断的是User、Product还是自定义的Order类型，只要写一个对应的断言函数，就能在任何地方复用，再也不用重复写as了。
注意2个关键，别踩坑
类型断言函数虽好用，但有两个细节要注意：
第一，它不是“万能作弊器”。你不能写function isString(value: unknown): value is string { return true; }——这种强行返回true的函数，会让TS认为所有值都是string，相当于自欺欺人，TS的类型检查就失去意义了；
第二，只做你确定的类型判断。比如你知道接口返回的age一定是number，就别去判断age的范围（比如是不是大于18），那是业务校验，不是类型断言的职责，断言只负责“这个值的结构是不是符合类型定义”。
说白了，类型断言函数就是TS给开发者留的“自定义类型校验工具”，把零散的类型判断变成可复用的逻辑，既解决了TS的类型报错问题，又能保持代码的整洁，是从TS入门到熟练的实用小技巧。