编译器诊断
配置项
默认值
说明
作用与用途
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
显示
这有帮助吗?