首页/开发/代码质量与评审速查/no-floating-promises:别让 Promise 悬空
规范与静态检查65 条

no-floating-promises:别让 Promise 悬空

未处理的 Promise 会导致错误被吞、执行顺序错乱:typescript-eslint 的 no-floating-promises 规则要求 await、显式 void 或统一错误处理。

问题Promise 未 await 也未 catch
规则@typescript-eslint/no-floating-promises
修复await / void / 统一收集处理

对比

对比
// 不好:失败无人知晓
loadUser();

// 好:显式处理
await loadUser();

// 或明确忽略(需评审确认合理)
void refreshCache();
近亲规则 no-misused-promises:async 函数传给期望返回 void 的位置同样是坑。

易错点

  • 用 void 批量消除告警:掩盖了真实的并发与错误处理问题
  • 只在部分文件启用:漏检文件继续吞错误

数据来源与参考

  • typescript-eslint 文档 · no-floating-promises 规则
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌