如何为TypeScript函数返回的重命名解构变量标注类型

• 第一种写法错误：对象解构重命名的语法规则是{ 源对象属性名: 自定义新变量名 }，对应的类型注解必须和等号右侧返回值的原始对象结构一致，不能写重命名后的变量名作为类型属性。你写的{ mixesError: string; mixes: any }相当于声明右侧返回的对象自带mixesError、mixes两个属性，但实际getArtist返回的对象属性是error和result，自然会报缺失属性的错误。
• 第二种写法错误：getArtist的返回值是典型的判别联合类型：成功时返回{ result: any[]; error?: undefined }，失败时返回{ error: any; result?: undefined }，两个属性互斥、不会同时存在。你写的{ error: string; result: any }要求两个属性必须同时为必选字段，和函数实际返回结构不匹配，依然会触发类型报错。

方案1：内联匹配返回结构（适合简单场景） #

按照函数实际返回的联合结构写类型，注意属性名用源对象的error/result，两个属性标记为可选，和返回值结构对齐：

const {
  error: mixesError,
  result: mixes,
}: {
  error?: string;
  result?: Artist[]; // 替换为你业务中实际的艺人数据类型，尽量避免用any，临时测试可写any[]
} = await getArtist(name);

方案2：复用函数自带类型（推荐，零冗余） #

如果getArtist本身已经定义过返回值类型，不需要重复手写内联类型，直接用TS内置工具类提取函数返回值类型即可，后续函数返回值变更时这里会自动同步，不用手动修改：

const {
  error: mixesError,
  result: mixes,
} = await getArtist(name) as Awaited<ReturnType<typeof getArtist>>;

标注完成后，TS会自动根据判别逻辑做类型收窄，不需要额外加类型断言：

if (mixesError) {
  // 此分支下TS自动推导: mixesError为string类型，mixes为undefined
  console.error('获取艺人数据失败:', mixesError);
  return;
}
// 此分支下TS自动推导: mixes为有效数据类型，mixesError为undefined
console.log('获取到的艺人混音列表:', mixes);

核心注意点：只要是解构重命名场景，类型注解永远描述的是等号右侧源值的结构，和重命名后的新变量名无关。

内容的提问来源于stack exchange，提问作者Franco