tsconfig.json

tsc --showConfig

# 使用自定义的配置文件
tsc --p tsconfig.page.json

{
  "compilerOptions": {
    // 导入 tslib 作为工具类
    // yarn add tslib
    "importHelpers": true,

    // 单文件模块 - 确保能够支持 transpileModule
    "isolatedModules": true,

    // 添加更多检测
    "strict": true,

    // 非绝对导入模块的基础路径
    "baseUrl": ".",
    // 从新映射模块路径
    "paths": {
      // 代码
      "src/*": ["src/*"],
      // 模块
      "jquery": ["node_modules/jquery/dist/jquery"]
    },

    // 多个虚拟代码目录 - 针对导入做合并处理
    "rootDirs": ["src/views", "generated/templates/views"],

    // 生成兼容 es 模块
    // 会启用 allowSyntheticDefaultImports
    "esModuleInterop": true,

    // 生成 .map
    "sourceMap": true,
    // 线上调试时 源码 路径
    "sourceRoot": "https://apis.wener.me/debug/sources/",
    // .map 文件路径
    "mapRoot": "https://apis.wener.me/debug/maps/",

    // 源码和 map 在 js 中 - 注释形式
    "inlineSourceMap": false,
    "inlineSources": false,

    // switch 不允许连续 - 除非 // falls through
    "noFallthroughCasesInSwitch": true,

    // 生成修饰器元数据
    "emitDecoratorMetadata": true,
    // 启用修饰器
    "experimentalDecorators": true,

    // 假设变更只影响直接依赖 - 大型项目增量构建有用
    "assumeChangesOnlyAffectDirectDependencies": true,

    // 3.8 - 导入只用于类型的时候移除 import
    // 避免副作用
    "importsNotUsedAsValues": "remove",

    // jsx 生成代码的工厂 - 例如 preact 用 preact.h
    "jsxFactory": "React.createElement",
    // XXX.createElement
    "reactNamespace": "React",

    // 允许导入 JSON
    "resolveJsonModule": true,
    // 错误时不生成文件
    "noEmitOnError": true,

    // 导入文件文件名大小写一致
    "forceConsistentCasingInFileNames": true,

    // 使用 TC39 定义类字段的方式
    "useDefineForClassFields": true
  }
}

{
  "compilerOptions": {
    // 不允许不可达的代码
    "allowUnreachableCode": false,
    // 不允许未使用的标签
    "allowUnusedLabels": false,
    // 生成 .d.ts
    "declaration": true,

    "forceConsistentCasingInFileNames": true,
    // 同 target
    "lib": ["es2018"],
    "module": "commonjs",
    "noEmitOnError": true,
    "noFallthroughCasesInSwitch": true,
    // 不允许隐性返回
    "noImplicitReturns": true,
    // 异常信息等使用颜色样式
    "pretty": true,
    // 生成 .map.js
    "sourceMap": true,
    "strict": true,
    "target": "es2018"
  },
  "exclude": ["node_modules"]
}