@quicksand-cloud/typescript-config/tsconfig.base.json

QuickSand Cloud TypeScript 配置 - 企业级 TypeScript 编译配置，支持多种项目场景（Node.js、React、通用）

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "compilerOptions": {
    /* 访问 https://aka.ms/tsconfig 以了解更多关于此文件的信息 */

    /* 项目配置 */
    // "incremental": true,                              /* 保存 .tsbuildinfo 文件以允许项目的增量编译。 */
    // "composite": true,                                /* 启用允许 TypeScript 项目与项目引用一起使用的约束。 */
    // "tsBuildInfoFile": "./.tsbuildinfo",              /* 指定 .tsbuildinfo 增量编译文件的路径。 */
    // "disableSourceOfProjectReferenceRedirect": true,  /* 在引用复合项目时禁用优先使用源文件而不是声明文件。 */
    // "disableSolutionSearching": true,                 /* 在编辑时选择退出多项目引用检查。 */
    // "disableReferencedProjectLoad": true,             /* 减少 TypeScript 自动加载的项目数量。 */

    /* 语言和环境 */
    "target": "esnext" /* 设置生成的 JavaScript 的 JavaScript 语言版本，并包含兼容的库声明。 */,
    "lib": ["ESNext"] /* 指定一组描述目标运行时环境的捆绑库声明文件。 */,
    "jsx": "react-jsx" /* 指定生成什么 JSX 代码。 */,
    // "libReplacement": true,                           /* 启用库替换。 */
    "experimentalDecorators": true /* 启用对旧版实验性装饰器的实验性支持。 */,
    "emitDecoratorMetadata": true /* 为源文件中的装饰声明发出设计类型元数据。 */,
    // "jsxFactory": "",                                 /* 指定在针对 React JSX 输出时使用的 JSX 工厂函数，例如 'React.createElement' 或 'h'。 */
    // "jsxFragmentFactory": "",                         /* 指定在针对 React JSX 输出时用于片段的 JSX Fragment 引用，例如 'React.Fragment' 或 'Fragment'。 */
    // "jsxImportSource": "",                            /* 指定在使用 'jsx: react-jsx*' 时用于导入 JSX 工厂函数的模块说明符。 */
    // "reactNamespace": "",                             /* 指定用于 'createElement' 的对象。这仅在针对 'react' JSX 输出时适用。 */
    // "noLib": true,                                    /* 禁用包含任何库文件，包括默认的 lib.d.ts。 */
    // "useDefineForClassFields": true,                  /* 发出符合 ECMAScript 标准的类字段。 */
    "moduleDetection": "force" /* 控制用于检测模块格式 JS 文件的方法。 */,

    /* 模块 */
    "module": "preserve" /* 指定生成什么模块代码。 */,
    // "rootDir": "./",                                  /* 指定源文件中的根文件夹。 */
    "moduleResolution": "bundler" /* 指定 TypeScript 如何从给定的模块说明符查找文件。 */,
    // "baseUrl": "./",                                  /* 指定用于解析非相对模块名称的基本目录。 */
    // "paths": {},                                      /* 指定一组将导入重新映射到其他查找位置的条目。 */
    // "rootDirs": [],                                   /* 允许在解析模块时将多个文件夹视为一个。 */
    // "typeRoots": [],                                  /* 指定多个像 './node_modules/@types' 一样工作的文件夹。 */
    // "types": [],                                      /* 指定要包含的类型包名称，而无需在源文件中引用。 */
    // "allowUmdGlobalAccess": true,                     /* 允许从模块访问 UMD 全局变量。 */
    // "moduleSuffixes": [],                             /* 解析模块时要搜索的文件名后缀列表。 */
    "allowImportingTsExtensions": true /* 允许导入包含 TypeScript 文件扩展名。需要设置 '--moduleResolution bundler' 和 '--noEmit' 或 '--emitDeclarationOnly'。 */,
    // "rewriteRelativeImportExtensions": true,          /* 在输出文件中将相对导入路径中的 '.ts'、'.tsx'、'.mts' 和 '.cts' 文件扩展名重写为其 JavaScript 等效项。 */
    // "resolvePackageJsonExports": true,                /* 在解析包导入时使用 package.json 的 'exports' 字段。 */
    // "resolvePackageJsonImports": true,                /* 在解析导入时使用 package.json 的 'imports' 字段。 */
    // "customConditions": [],                           /* 在解析导入时设置除解析器特定默认值之外的条件。 */
    // "noUncheckedSideEffectImports": true,             /* 检查副作用导入。 */
    // "resolveJsonModule": true,                        /* 启用导入 .json 文件。 */
    // "allowArbitraryExtensions": true,                 /* 启用导入具有任何扩展名的文件，前提是存在声明文件。 */
    // "noResolve": true,                                /* 禁止 'import'、'require' 或 '<reference>' 扩展 TypeScript 应添加到项目中的文件数量。 */

    /* JavaScript 支持 */
    "allowJs": true /* 允许 JavaScript 文件成为程序的一部分。使用 'checkJS' 选项从这些文件中获取错误。 */,
    // "checkJs": true,                                  /* 在类型检查的 JavaScript 文件中启用错误报告。 */
    // "maxNodeModuleJsDepth": 1,                        /* 指定用于检查 'node_modules' 中的 JavaScript 文件的最大文件夹深度。仅在使用 'allowJs' 时适用。 */

    /* 输出 */
    // "declaration": true,                              /* 从项目中的 TypeScript 和 JavaScript 文件生成 .d.ts 文件。 */
    // "declarationMap": true,                           /* 为 d.ts 文件创建源映射。 */
    // "emitDeclarationOnly": true,                      /* 仅输出 d.ts 文件而不输出 JavaScript 文件。 */
    // "sourceMap": true,                                /* 为生成的 JavaScript 文件创建源映射文件。 */
    // "inlineSourceMap": true,                          /* 在生成的 JavaScript 中包含源映射文件。 */
    "noEmit": true /* 禁用从编译中发出文件。 */,
    // "outFile": "./",                                  /* 指定一个将所有输出捆绑到一个 JavaScript 文件中的文件。如果 'declaration' 为 true，则还指定一个捆绑所有 .d.ts 输出的文件。 */
    // "outDir": "./",                                   /* 为所有生成的文件指定输出文件夹。 */
    // "removeComments": true,                           /* 禁用生成注释。 */
    // "importHelpers": true,                            /* 允许从 tslib 导入辅助函数，每个项目一次，而不是每个文件都包含它们。 */
    // "downlevelIteration": true,                       /* 为迭代发出更兼容但冗长且性能较低的 JavaScript。 */
    // "sourceRoot": "",                                 /* 指定调试器查找参考源代码的根路径。 */
    // "mapRoot": "",                                    /* 指定调试器应定位映射文件的位置，而不是生成的位置。 */
    // "inlineSources": true,                            /* 在生成的 JavaScript 中的源映射中包含源代码。 */
    // "emitBOM": true,                                  /* 在输出文件的开头发出 UTF-8 字节顺序标记 (BOM)。 */
    // "newLine": "crlf",                                /* 设置生成文件的新行字符。 */
    // "stripInternal": true,                            /* 禁用生成在其 JSDoc 注释中包含 '@internal' 的声明。 */
    // "noEmitHelpers": true,                            /* 禁用在编译输出中生成自定义辅助函数，如 '__extends'。 */
    // "noEmitOnError": true,                            /* 如果报告了任何类型检查错误，则禁用生成文件。 */
    // "preserveConstEnums": true,                       /* 禁用在生成的代码中擦除 'const enum' 声明。 */
    // "declarationDir": "./",                           /* 指定生成的声明文件的输出目录。 */

    /* 互操作性约束 */
    // "isolatedModules": true,                          /* 确保每个文件都可以安全地转译，而不依赖于其他导入。 */
    "verbatimModuleSyntax": true /* 不转换或省略任何未标记为仅类型的导入或导出，确保它们根据 'module' 设置以输出文件的格式写入。 */,
    // "isolatedDeclarations": true,                     /* 要求导出有足够的注释，以便其他工具可以轻松生成声明文件。 */
    // "erasableSyntaxOnly": true,                       /* 不允许不属于 ECMAScript 的运行时构造。 */
    // "allowSyntheticDefaultImports": true,             /* 当模块没有默认导出时，允许 'import x from y'。 */
    "esModuleInterop": true /* 发出额外的 JavaScript 以简化对导入 CommonJS 模块的支持。这为类型兼容性启用了 'allowSyntheticDefaultImports'。 */,
    // "preserveSymlinks": true,                         /* 禁用将符号链接解析为其真实路径。这与 node 中的相同标志相关。 */
    "forceConsistentCasingInFileNames": true /* 确保导入中的大小写正确。 */,

    /* 类型检查 */
    "strict": true /* 启用所有严格类型检查选项。 */,
    // "noImplicitAny": true,                            /* 为具有隐含 'any' 类型的表达式和声明启用错误报告。 */
    // "strictNullChecks": true,                         /* 在类型检查时考虑 'null' 和 'undefined'。 */
    // "strictFunctionTypes": true,                      /* 在分配函数时，检查以确保参数和返回值是子类型兼容的。 */
    // "strictBindCallApply": true,                      /* 检查 'bind'、'call' 和 'apply' 方法的参数是否与原始函数匹配。 */
    // "strictPropertyInitialization": true,             /* 检查在构造函数中声明但未设置的类属性。 */
    // "strictBuiltinIteratorReturn": true,              /* 内置迭代器使用 'undefined' 而不是 'any' 的 'TReturn' 类型实例化。 */
    // "noImplicitThis": true,                           /* 当 'this' 被赋予 'any' 类型时启用错误报告。 */
    // "useUnknownInCatchVariables": true,               /* 将 catch 子句变量默认为 'unknown' 而不是 'any'。 */
    // "alwaysStrict": true,                             /* 确保始终发出 'use strict'。 */
    "noUnusedLocals": true /* 在未读取局部变量时启用错误报告。 */,
    "noUnusedParameters": false /* 当函数参数未被读取时引发错误。 */,
    // "exactOptionalPropertyTypes": true,               /* 按原样解释可选属性类型，而不是添加 'undefined'。 */
    // "noImplicitReturns": true,                        /* 为函数中未显式返回的代码路径启用错误报告。 */
    "noFallthroughCasesInSwitch": true /* 为 switch 语句中的贯穿情况启用错误报告。 */,
    "noUncheckedIndexedAccess": true /* 在使用索引访问时向类型添加 'undefined'。 */,
    "noImplicitOverride": true /* 确保派生类中的覆盖成员标记有 override 修饰符。 */,
    "noPropertyAccessFromIndexSignature": true /* 强制使用索引访问器来访问使用索引类型声明的键。 */,
    // "allowUnusedLabels": true,                        /* 禁用对未使用标签的错误报告。 */
    // "allowUnreachableCode": true,                     /* 禁用对不可达代码的错误报告。 */

    /* 完整性 */
    // "skipDefaultLibCheck": true,                      /* 跳过对 TypeScript 包含的 .d.ts 文件的类型检查。 */
    "skipLibCheck": true /* 跳过对所有 .d.ts 文件的类型检查。 */
  }
}