TS配置

TypeScript

顶层

• files

• extends
  取决于运行时，可以通过 extends 字段来选择继承的 tsconfig.json，TS 仓库提供了一些基本配置

{
    "extends": "@tsconfig/node/12/tsconfig.json",
    "compilerOptions": {
        "preserveConstEnums": true
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", "**/*.spec.ts"]
}

• include

• exclude

• references（指定一组包含 tsconfig.json 的 project path）

• compilerOptions

• watchOptions

Compiler Options

类型检查

• allowUnreachableCode

• allowUnusedLabels

• alwaysStrict

• exactOptionalPropertyTypes

• noFallthroughCasesInSwitch

• noImplicitAny

• noImplicitOverride

• noImplicitReturns

• noImplicitThis

• noPropertyAccessFromIndexSignature

• noUncheckedIndexedAccess

• noUnusedLocals

• noUnusedParameters

• strict

• strictBindCallApply

• strictFunctionTypes

• strictNullChecks

• strictPropertyInitialization

• useUnknownInCatchVariables

模块

• allowUmdGlobalAccess

• baseUrl

• module

• moduleResolution

• moduleSuffixes

• noResolve

• paths

• resolveJsonModule

• rootDir

• rootDirs

• typeRoots

• types

输出

• declaration

• declarationDir

• declarationMap

• downlevelIteration

• emitBOM

• emitDeclarationOnly

• importHelpers

• importsNotUsedAsValues

• inlineSourceMap

• inlineSources

• mapRoot

• newLine

• noEmit

• noEmitHelpers

• noEmitOnError

• outDir

• outFile
  If specified, all global (non-module) files will be concatenated into the single output file specified.
  If module is system or amd, all module files will also be concatenated into this file after all global content.

• preserveConstEnums
  Do not erase const enum declarations in generated code.

• preserveValueImports

• removeComments

• sourceMap

• sourceRoot

• stripInternal

• noErrorTruncation

• preserveWatchOutput

• pretty

JS支持

• allowJs

• checkJs

• maxNodeModuleJsDepth

互操作约束

• allowSyntheticDefaultImports

• esModuleInterop

• forceConsistentCasingInFileNames

• isolatedModules

• preserveSymlinks

语言和环境

• emitDecoratorMetadata

• experimentalDecorators

• jsx

• jsxFactory

• jsxFragmentFactory

• jsxImportSource

• lib

• moduleDetection

• noLib

• reactNamespace

• target

• useDefineForClassFields

构建

• composite
  The composite option enforces certain constraints which make it possible for build tools (including TypeScript itself, under --build mode) to quickly determine if a project has been built yet.

  • rootDir 默认需要指定
  • 所有要用的文件必须在 include 或 files 里指定，否则 tsc 会通知错误
  • declaration 默认是 true

• disableReferencedProjectLoad

• disableSolutionSearching

• disableSourceOfProjectReferenceRedirect

• incremental

• tsBuildInfoFile

完整性

• skipLibCheck

watchOptions

配置 tsc -w 的选项
- watchFile

• watchDirectory

• fallbackPolling

• synchronousWatchDirectory

• excludeDirectories

• excludeFiles