编译器诊断

配置项
默认值
说明
作用与用途

diagnostics

false

显示编译器性能相关信息,例如解析、绑定和检查阶段耗时。

用于性能分析,有助于定位编译瓶颈。

explainFiles

false

显示每个文件为何会被包含在编译中(例如是被哪个文件引用的)。

调试包含范围(包括 include, exclude, files)相关问题。

extendedDiagnostics

false

显示更详细的性能信息,包括每一步具体耗时。

diagnostics 更详细,适用于深度性能调优。

generateCpuProfile

无默认值

生成 CPU 性能分析文件(.cpuprofile),可在 Chrome DevTools 中查看。值为文件路径:"profile.cpuprofile"

用于定位性能瓶颈,适合大项目构建分析。

generateTrace

无默认值

生成构建过程的完整跟踪文件(JSON 格式)。值为目录路径。

适合在诊断复杂构建问题时使用。

listEmittedFiles

false

编译时在控制台列出所有生成的输出文件。

用于调试输出情况,尤其是在增量构建或输出文件丢失时。

listFiles

false

编译时列出参与编译的所有输入文件。

explainFiles 搭配使用有助于调试文件包含规则。

noCheck

false

跳过类型检查,只做语法检查和文件输出(类似 Babel 行为)。

用于仅输出 JS 文件、不进行类型检查的场景。提升速度。

traceResolution

false

显示

这有帮助吗?