TypeScript 中的 emitDeclarationOnly

说明 emitDeclarationOnly 为什么只生成 .d.ts 而不生成 .js，以及它为什么常见于使用 Babel、SWC、esbuild 或 bundler 负责转译的项目。

#tech / dev #resource / typescript #type / concept #status / growing

[!info] related notes

所属 MOC: TypeScript MOC

配置入口: tsconfig 使用详解

并列概念: TypeScript 中的 declaration 与 declarationMap, TypeScript 中的 noEmit

一句话定义

emitDeclarationOnly 表示 TypeScript 只生成 .d.ts，不生成 .js。

官方文档直接给出的定义是：

它最适合两类场景：

{
  "compilerOptions": {
    "declaration": true,
    "emitDeclarationOnly": true
  }
}

这常见于：

noEmit 是：

而 emitDeclarationOnly 是：

因为没有声明输出目标时，这个选项本身就失去意义。

如果 JS 输出本来就完全依赖 bundler 或其他 transpiler，这个选项会比直接让 tsc 产出完整 JS 更清晰。