TypeScript严格模式（strictNullChecks: true）下未找到对象时应返回什么？最佳实践是什么？

当开启strictNullChecks时，TypeScript会严格校验空值类型，你代码里返回null给类型T报错，核心原因是T本身并未包含null类型。下面是几种可行的替代方案和对应的最佳实践：

方案1：修改返回类型为T | null #

这是最直接且符合类型安全原则的做法，明确告知TypeScript该方法的返回值要么是T类型的有效值，要么是null。修改后的代码如下：

getItem(key: string): T | null { 
  let index: number = this.contains(key); // 未找到时返回-1
  if (index === -1) { 
    return null; // 类型匹配，不再报错
  } 
  return this.map[index].value; 
}

这么做的好处是，调用该方法的代码必须显式处理null情况（比如用可选链?.、空值合并??或者条件判断），从根源上避免潜在的空值引用错误。

方案2：抛出错误 #

如果“找不到元素”在你的业务逻辑里属于异常场景（比如程序逻辑保证key一定存在，但实际运行时未找到），抛出错误会更合适。此时方法的返回类型可以保持为T，因为只有成功找到元素时才会返回值：

getItem(key: string): T { 
  let index: number = this.contains(key);
  if (index === -1) { 
    throw new Error(`Item with key "${key}" was not found`);
  } 
  return this.map[index].value; 
}

这种方式适合需要快速定位逻辑错误的场景，调用方需要通过try/catch捕获异常，或者确保传入的key一定存在。

最佳实践总结 #

• 优先选择T | null：当找不到元素是预期的正常场景（比如用户搜索不存在的内容），这种方式能借助类型系统强制处理空值，提升代码可靠性。
• 抛出错误仅用于异常场景：如果找不到元素意味着程序逻辑出错，抛出错误能快速暴露问题，避免错误被隐藏。
• 绝对不要关闭strictNullChecks或者用any绕过检查：这会丢失TypeScript类型安全的核心优势，反而埋下更多隐患。

内容的提问来源于stack exchange，提问作者Martin 膶uka