编译器配置项-compilerOptions

编译诊断配置项01

诊断 - diagnostics

用于输出调试的诊断信息。此命令是 extendedDiagnostics 的子集，它的输出结果更面向用户，并且更易于解释。

如果 TypeScript 编译器工程师要求您在编译中使用此标志给出结果，那么改用 extendedDiagnostics 不会有什么坏处。

解释文件 - explainFiles

打印 TypeScript 视为项目一部分的文件名以及它们成为编译一部分的原因。

例如，对于这个只有一个文件的项目index.ts:

example
├── index.ts
├── package.json
└── tsconfig.json

使用的 tsconfig.json 将 explainFiles 设置为了 true :

{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "explainFiles": true
  }
}

对此文件夹运行 TypeScript 将产生如下输出：

❯ tsc
node_modules/typescript/lib/lib.d.ts
  Default library for target 'es5'
node_modules/typescript/lib/lib.es5.d.ts
  Library referenced via 'es5' from file 'node_modules/typescript/lib/lib.d.ts'
node_modules/typescript/lib/lib.dom.d.ts
  Library referenced via 'dom' from file 'node_modules/typescript/lib/lib.d.ts'
node_modules/typescript/lib/lib.webworker.importscripts.d.ts
  Library referenced via 'webworker.importscripts' from file 'node_modules/typescript/lib/lib.d.ts'
node_modules/typescript/lib/lib.scripthost.d.ts
  Library referenced via 'scripthost' from file 'node_modules/typescript/lib/lib.d.ts'
index.ts
  Matched by include pattern '**/*' in 'tsconfig.json'

上面的输出显示：

• 基于target的配置查找lib.d.ts，以及它引用的.d.ts文件
• 通过 include 默认模式找到的文件index.ts

此选项用于解释调试过程中文件如何成为编译的一部分。