Angular项目构建报错：tsconfig未配置指定组件文件

我之前搭建Angular项目时也碰到过完全一样的问题，别担心，咱们从最常见的原因开始排查解决：

1. 检查TypeScript配置文件的include字段 #

Angular会根据tsconfig系列文件的配置来决定哪些文件需要编译。你需要确认**src/tsconfig.app.json**（这是应用级的TypeScript配置，继承根目录的tsconfig.json）里的include数组是否覆盖了你的组件路径：

• 打开src/tsconfig.app.json，找到include节点
• 确保里面包含通配符配置"src/**/*.ts"（这会匹配src目录下所有.ts文件，包括你的home.component.ts）
• 如果通配符没生效，也可以直接添加该组件的具体路径作为兜底

示例配置如下：

{
  "extends": "../tsconfig.json",
  "compilerOptions": {
    "outDir": "../out-tsc/app",
    "types": []
  },
  "include": [
    "src/**/*.ts",
    "src/app/views/home/home.component.ts" // 可选：如果通配符没覆盖到，添加这行
  ],
  "exclude": [
    "src/test.ts",
    "src/**/*.spec.ts"
  ]
}

2. 清理Angular构建缓存 #

有时候配置已经正确，但旧的构建缓存会导致错误残留。执行以下命令清理缓存后重新构建：

ng clean
ng build

3. 检查文件路径大小写（Windows环境注意） #

虽然Windows系统不区分文件名大小写，但TypeScript编译时对路径大小写是敏感的。比如如果你在组件引用、路由配置里写的是Home.Component.ts，但实际文件是home.component.ts，就可能触发这个错误。确认所有引用路径和实际文件名的大小写完全一致。

4. 自定义Webpack配置的特殊情况（进阶） #

如果你手动修改了Angular的Webpack配置（比如用了@angular-builders/custom-webpack），需要检查AngularCompilerPlugin的配置，确保它的include选项包含了你的组件文件路径。不过这种情况在普通Angular CLI项目里很少见，优先排查前面的步骤。

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