Angular15升级后TypeScript编译未使用文件警告的解决求助

1. 修正废弃的Angular编译器配置 #

你的tsconfig.app.json中存在Angular 15已废弃的顶级angularOptions配置，需将其合并到angularCompilerOptions中，同时调整编译文件的包含/排除规则：

{
  "extends": "../tsconfig.json",
  "compilerOptions": {
    "outDir": "../out-tsc/app",
    "baseUrl": "./",
    "types": []
  },
  "files": [
    "src/main.ts",
    "src/polyfills.ts"
  ],
  "include": [
    "src/**/*.d.ts",
    "src/**/*.ts" // 明确包含应用所有TS文件，避免CLI自动扫描出现偏差
  ],
  "exclude": [
    "src/test.ts",
    "src/environments/environment.prod.ts", // 排除非默认环境的配置文件
    "src/environments/environment.*.ts" // 通配符批量排除所有带后缀的环境文件
  ],
  "angularCompilerOptions": {
    "enableResourceInlining": true,
    "generateCodeForLibraries": true,
    "compilationMode": "partial",
    "annotationsAs": "decorators" // 将原angularOptions的配置移至此
  }
}

2. 为生产环境配置独立TSConfig #

在项目根目录新建或编辑tsconfig.prod.json，明确指定生产环境所需的文件：

{
  "extends": "./tsconfig.app.json",
  "exclude": [
    "src/test.ts",
    "src/environments/environment.ts" // 排除开发环境文件
  ],
  "include": [
    "src/environments/environment.prod.ts" // 仅包含生产环境配置文件
  ]
}

3. 关联Angular构建配置 #

确保angular.json中生产环境的构建配置指向上述tsconfig.prod.json：

"configurations": {
  "production": {
    "tsConfig": "tsconfig.prod.json",
    // 其他生产环境配置（如优化、输出路径等）保持不变
  }
}

4. 清理缓存并重新构建 #

执行以下命令清除Angular缓存，确保新配置生效：

ng cache clean
ng build --configuration=production

关键说明 #

Angular 15对TypeScript编译上下文的校验机制更严格，不再允许未被引用的文件被纳入默认编译范围。通过分环境配置TSConfig，确保每个构建目标只加载对应环境所需的文件，从根源消除此类警告。

内容的提问来源于stack exchange，提问作者Tweety