Angular 5多模块项目执行ng build --prod时编译失败求助

针对你执行ng build --prod时每个模块都出现的Module build failed: Error: ... is missing from the TypeScript compilation错误，我整理了几个最有效的排查和解决步骤：

1. 检查tsconfig.json的include配置 #

这是触发该错误最核心的原因，得确保所有模块文件都被TypeScript编译器纳入编译范围。打开根目录下的tsconfig.json，找到include数组，确认它覆盖了你的模块所在路径：

{
  "include": [
    "src/**/*", // 通配符会包含src下所有层级的文件，自然覆盖子目录里的模块
    "src/app/Modules/**/*" // 也可以单独指定模块目录，做双重保险
  ]
}

注意：如果你的tsconfig.json里有files数组，也要确保模块文件被手动添加进去，但更推荐用include的通配符来批量覆盖所有需要编译的文件，避免遗漏。

2. 清理Angular构建缓存 #

有时候旧缓存会导致莫名其妙的编译异常，执行以下命令彻底清理缓存：

ng cache clean --all
rm -rf node_modules/.cache

如果担心依赖有冲突，也可以重新安装依赖：

npm install

3. 验证模块导入路径的正确性 #

仔细检查所有模块的导入语句，确保路径没有拼写错误、大小写问题（macOS文件系统大小写不敏感，但编译时可能触发匹配失败）。比如：

// 错误示例：路径拼写或大小写不匹配实际文件
import { ProfileModule } from './modules/profile/Profile.module';
// 正确示例：严格匹配实际文件路径和文件名
import { ProfileModule } from './modules/profile/profile.module';

4. 检查angular.json的构建配置 #

确认angular.json里的构建配置指向了正确的TypeScript配置文件：

{
  "projects": {
    "your-project-name": {
      "architect": {
        "build": {
          "options": {
            "tsConfig": "tsconfig.app.json" // 确保这个路径指向正确的配置文件
          }
        }
      }
    }
  }
}

如果使用的是tsconfig.app.json，也要检查这个文件的include配置，确保它继承了根tsconfig.json的规则，或者自身包含了模块路径。

5. 更新Angular CLI到稳定版本 #

如果你的Angular CLI版本较旧，可能存在已知的编译bug。执行以下命令更新到最新稳定版：

npm install -g @angular/cli
npm install @angular/cli --save-dev

更新完成后重新执行构建命令：

ng build --prod

如果以上步骤都试过仍未解决，可以尝试彻底重置依赖和构建文件：

rm -rf node_modules dist
npm install
ng build --prod

内容的提问来源于stack exchange，提问作者Amr M. Kayid