TypeScript 策略
类型感知文件必须属于 Project Service 可发现的 tsconfig.json。
explicit-module-boundary-types: "error":.ts、.mts、.cts导出函数及导出类的公共边界必须显式声明参数和返回类型。.tsx默认关闭模块边界类型强制:组件 Props 继续接受 TypeScript 检查,但不要求补写可稳定推断的 JSX 返回类型。explicit-function-return-type: "off":内部函数、局部处理函数和内联回调使用 TypeScript 推断。no-inferrable-types不删除参数和属性上的显式类型。- Vue/NVue SFC 与独立 TSX 组件不强制模块边界和函数返回类型,以保留常见简洁写法。
no-floating-promises关闭;是否等待 Promise 由业务顺序和异常语义决定。no-void: "error":不使用void promise或其他void表达式规避检查。require-await: "error":没有真实await的函数应删除async,避免改变返回值和异常语义。no-misused-promises、await-thenable、unsafe 类型规则及精选的高置信度类型规则保持为错误。- TSX 与 Vue/NVue SFC 对
no-misused-promises设置checksVoidReturn: { attributes: false, properties: false },允许向期望() => void的 JSX 属性和对象属性传入 Promise 返回函数;普通 TypeScript 文件保持原检查。此豁免不保证调用方处理 Promise 拒绝,函数参数、变量赋值、条件判断等其他检查仍然启用。 - 标准非空断言可用;矛盾、重复或无效的断言仍由专项规则检查。
- 数字和布尔值可直接用于模板字符串;运行时防御性条件不会因类型看似多余而报错。
