TypeScript递归类型别名替代any的问题咨询

针对你遇到的TypeScript类型定义问题，这里有几个实用的优化方向：

1. 用区分联合类型明确API返回的所有可能结构 #

与其用宽泛的Json类型或自定义数组接口，不如直接定义API返回的所有可能类型的联合，让TypeScript能准确做类型推断：

// 保留递归Json类型，用于描述复杂嵌套结构
type Json = string | number | boolean | null | Json[] | { [key: string]: Json };

// 定义API返回的错误字符串类型
type ApiError = "error";

// 定义带reasonCode和message的响应结构，同时允许其他任意JSON属性
interface ApiSuccessResponse {
  reasonCode: string;
  message: string;
  // 兼容API返回的其他未知JSON属性
  [key: string]: Json;
}

// 最终的API返回类型
type ApiResult = ApiError | ApiSuccessResponse;

使用时通过类型分支自动推断：

const result: ApiResult = await yourApiCall();

if (result === "error") {
  // TypeScript自动推断result为ApiError类型
  console.log("请求触发错误标识");
} else {
  // 自动推断为ApiSuccessResponse，可安全访问reasonCode、message
  console.log(result.reasonCode, result.message);
  // 其他嵌套的JSON属性也能正常访问
}

2. 处理特殊的数组+额外属性场景（若API确实如此返回） #

如果你的API真的返回带额外属性的数组（不符合标准JSON规范，但部分后端可能这么实现），可以给联合类型加上数组接口，并自定义类型守卫来区分：

type Json = string | number | boolean | null | Json[] | { [key: string]: Json };
type ApiError = "error";

interface ApiResponseArray extends Array<Json> {
  reasonCode: string;
  message: string;
}

type ApiResult = ApiError | ApiResponseArray;

// 自定义类型守卫，判断是否为带属性的数组
function isApiResponseArray(value: ApiResult): value is ApiResponseArray {
  return typeof value !== "string" && "reasonCode" in value;
}

使用时：

const result: ApiResult = await yourApiCall();

if (result === "error") {
  console.log("请求错误");
} else if (isApiResponseArray(result)) {
  console.log(result.reasonCode, result.message);
  // 同时可以正常使用数组方法，比如result.forEach(...)
}

3. 避免过度宽泛的类型定义 #

尽量不要直接用Json作为返回类型，因为它太宽泛，TypeScript无法帮你检查具体属性。通过明确联合类型，既能保留类型安全，又不会让代码显得繁琐。

如果API返回的结构非常多变，也可以在需要访问特定属性时，用类型守卫+类型断言临时缩小范围，但不建议滥用：

if (typeof result !== "string" && "reasonCode" in result) {
  console.log((result as { reasonCode: string }).reasonCode);
}

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