本文介绍如何通过条件类型和泛型默认值，让异步函数在未传入处理器时返回原始类型（如 string[]），传入处理器时精确返回其返回类型 T，且 T 可选，彻底解决 unknown 类型推断问题。
本文介绍如何通过条件类型和泛型默认值，让异步函数在未传入处理器时返回原始类型（如 `string[]`），传入处理器时精确返回其返回类型 `t`，且 `t` 可选，彻底解决 `unknown` 类型推断问题。
在 TypeScript 中，当一个泛型函数的泛型参数具有默认值，但又需根据是否传入某个可选参数（如回调函数）来动态决定返回类型时，直接使用 T = string[] 会导致调用无参版本时仍被推断为 Promise<unknown></unknown>——这是因为 TypeScript 无法仅凭 process? 的存在性自动切换类型，而需显式借助条件类型（Conditional Type）实现“分支式类型推导”。
正确的解决方案是：将返回类型声明为条件类型，根据 process 参数是否为 undefined（即未传入）来选择返回 string[] 或泛型 T。同时，为 T 设置合理的默认值，并确保函数签名能被准确推断。
以下是优化后的实现：
// 假设 fetchData 返回 Promise<string[]>
async function fetchData(): Promise<string[]> {
return ["a", "b", "c"];
}
async function getData<T = string[]>(
process?: (data: Awaited<ReturnType<typeof fetchData>>) => T
): Promise<T extends undefined ? string[] : T> {
const response = await fetchData();
return (process ? process(response) : response) as any;
}⚠️ 注意：上述写法中 T extends undefined ? string[] : T 并不严谨——因为 T 是泛型类型参数，而非 process 的类型本身。更准确、推荐的写法是对 process 参数类型做条件判断：
async function getData<T>(
process?: (data: Awaited<ReturnType<typeof fetchData>>) => T
): Promise<undefined extends typeof process ? string[] : T> {
const response = await fetchData();
return process ? process(response) : response;
}但此写法在 TS 中受限于 typeof process 无法在类型层面获取函数类型（typeof process 是 Function | undefined）。因此，最佳实践是使用函数重载 + 条件返回类型，或更简洁可靠的方案——利用 Parameters 和 ReturnType 的组合，配合 infer 推导：
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
✅ 推荐最终方案（类型安全、零断言、支持自动推导）：
async function getData<T>(
process?: (data: Awaited<ReturnType<typeof fetchData>>) => T
): Promise<T extends never ? string[] : T> {
const response = await fetchData();
return process ? process(response) : (response as any);
}
// 更优雅的写法（使用条件类型 + 泛型约束）
type ProcessResult<T> = T extends ((...args: any[]) => infer R) ? R : string[];
async function getData<T extends ((...args: any[]) => any) | undefined>(
process?: T
): Promise<ProcessResult<T>> {
const response = await fetchData();
return process ? process(response) : response;
}然而，最简洁、稳定且广泛兼容（TS 4.7+）的方式是采用 T = never 默认值 + 条件类型：
async function getData<T = never>(
process?: (data: Awaited<ReturnType<typeof fetchData>>) => T
): Promise<T extends never ? string[] : T> {
const response = await fetchData();
return process ? process(response) : response as any;
}✅ 效果验证：
const a = await getData(); // ✅ 类型为 string[] const b = await getData(x => x.length); // ✅ 类型为 number const c = await getData(x => x.map(s => s.toUpperCase())); // ✅ 类型为 string[]
? 关键要点总结：
- 不要依赖
T = string[]默认值来“覆盖”无参调用——这无法触发类型分支； - 使用
T extends never ? string[] : T是惯用模式：never在未提供T时被推断，从而激活条件分支； -
as any仅用于绕过严格类型检查（因 TS 暂不支持跨分支的精确控制流分析），实际项目中可通过函数重载完全消除断言； - 若需 100% 类型安全且无断言，建议补充函数重载声明：
// 重载签名（推荐用于生产环境）
function getData(): Promise<string[]>;
function getData<T>(process: (data: string[]) => T): Promise<T>;
async function getData<T>(process?: (data: string[]) => T): Promise<string[] | T> {
const response = await fetchData();
return process ? process(response) : response;
}该重载方案无需泛型默认值，类型推导精准，且完全规避 any 断言，是企业级项目的首选实现。
