Angular项目编译启动报错：仅支持--outFile搭配'amd'和'system'模块

我之前也碰到过类似的情况，虽然你没手动加--outFile参数，但这个报错通常是TypeScript配置文件里的模块设置冲突，或者Angular CLI的隐含配置触发了outFile相关校验导致的。给你几个一步步排查的方案：

• 检查主tsconfig.json的核心配置
  打开项目根目录的tsconfig.json，重点看compilerOptions里的这两个字段：

  1. 确保"module"的值是"ES2020"、"ESNext"或者Angular推荐的模块类型，不要用commonjs——因为commonjs模块和outFile（哪怕是CLI隐含启用的）不兼容。
  2. 确认配置里没有显式设置"outFile"字段，如果有直接删除掉。

• 排查附属tsconfig文件
  除了主配置，还要检查tsconfig.app.json这类细分配置（比如针对应用代码的配置），确保它们的compilerOptions里：

  • 没有继承或设置"module": "commonjs"
  • 也没有"outFile"相关配置

• 清理项目缓存与依赖
  有时候缓存会导致配置不生效，执行以下步骤：

  1. 运行ng cache clean清理Angular CLI缓存
  2. 删除项目根目录的node_modules文件夹和package-lock.json（或yarn.lock）
  3. 重新执行npm install（或yarn install）安装依赖
  4. 再尝试ng build或ng serve

• 检查angular.json的构建配置
  打开angular.json，找到对应项目的build和serve配置节点，检查options里有没有可能触发outFile的自定义设置——比如某些自定义webpack配置或者过时的输出配置，确保没有和模块类型冲突的设置。

• 升级Angular CLI版本（可选）
  如果你的Angular CLI版本比较旧，可能和当前TypeScript版本存在兼容性问题。可以尝试执行：

  ng update @angular/cli @angular/core
  

  注意升级前最好备份项目，避免版本冲突导致其他问题。

为什么会出现这个报错？ #

Angular默认使用ES模块来构建项目，而TypeScript的outFile选项只支持amd和system两种模块类型。哪怕你没手动加--outFile，如果某个配置文件里隐含开启了这个选项（或者CLI的某些逻辑触发了它），同时模块类型不是amd/system，就会抛出这个错误。

内容的提问来源于stack exchange，提问作者Iñigo