在 Angular 项目中，"tsconfig.api-extractor.json" 是一个用于配置 API Extractor 工具的配置文件。API Extractor 是一个用于生成和管理 TypeScript 库的 API 文档的工具。它能够从 TypeScript 代码中提取公共 API 并生成清晰的文档，以便开发者能够更好地了解库的使用方式、函数、类、接口等。
"tsconfig.api-extractor.json" 文件是用于指导 API Extractor 的工作流程和行为的配置文件。它定义了用于生成 API 文档的源代码位置、输出目录、文件筛选规则、包含和排除的文件列表，以及其他相关的选项。
该配置文件通常位于项目的根目录下，并且以"tsconfig.api-extractor.json"的名称保存。在 Angular 项目中，它通常是与其他 TypeScript 配置文件（例如 "tsconfig.json"）并存的。
下面是一个示例的 "tsconfig.api-extractor.json" 配置文件内容：
{
"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
"mainEntryPointFilePath": "<path_to_entry_point_file>",
"dtsRollup": {
"enabled": true,
"publicTrimmedFilePath": "<path_to_public_trimmed_file>",
"betaTrimmedFilePath": "<path_to_beta_trimmed_file>",
"alphaTrimmedFilePath": "<path_to_alpha_trimmed_file>"
},
"apiReport": {
"enabled": true,
"reportFileName": "<api_report_filename>"
},
"docModel": {
"enabled": true
},
"docModelJson": {
"enabled": true,
"outputFolder": "<output_folder_path>"
},
"compiler": {
"configType": "tsconfig",
"rootFolder": ".",
"overrideTsconfig": {
"extends": "./tsconfig.json",
"compilerOptions": {
"outDir": "./dist"
}
}
}
}在上述配置文件中，可以看到以下重要的配置选项：
- "mainEntryPointFilePath"：指定库的入口文件路径，API Extractor 将从该文件开始提取 API。
- "dtsRollup"：配置生成的 API 文件的路径和选项。
- "apiReport"：配置是否生成 API 报告以及报告文件的名称。
- "docModel" 和 "docModelJson"：配置是否启用生成 API 文档模型和相应的输出文件夹路径。
- "compiler"：与 TypeScript 编译器相关的配置，指定了编译器选项和路径。
通过配置 "tsconfig.api-extractor.json" 文件，开发者可以根据项目需求自定义 API Extractor 工具的行为，并生成清晰的 API 文档以供开发者使用和参考。
需要注意的是，"tsconfig.api-extractor.json" 是 Angular 项目中特定于 API Extractor 的配置文件，用于生成 API 文档。与此同时，还存在其他 TypeScript 配置文件（例如 "tsconfig.json"）用于控制 TypeScript 编译器的行为。
