Angular CLI 20.0.0-next.8 中 --minimal 标志的配置问题分析

在最新发布的 Angular CLI 20.0.0-next.8 版本中，开发者发现了一个与项目初始化配置相关的问题。当使用 --minimal 标志创建新项目时，TypeScript 配置文件(tsconfig.json)中仍然包含了测试相关的配置引用，这显然与 minimal 标志的设计初衷相违背。

问题现象

当开发者执行以下命令创建新项目时：

npx @angular/cli@next new tmp-app --minimal

生成的 tsconfig.json 文件中包含了两个路径引用：

"references": [
  {
    "path": "./tsconfig.app.json"
  },
  {
    "path": "./tsconfig.spec.json"
  }
]

其中 tsconfig.spec.json 是用于测试的配置文件，但在 minimal 模式下这个文件实际上并不会被创建。这导致了开发环境（如 VS Code）会报出文件未找到的错误。

问题影响

这个问题虽然不会直接影响应用的运行，但会带来以下不良影响：

1. 开发体验下降：IDE会持续显示文件未找到的警告
2. 配置冗余：minimal 模式本应提供最简配置，多余的引用违背了这一原则
3. 潜在混淆：开发者可能会误以为测试配置已准备就绪

深入分析

进一步检查发现，这个问题不仅存在于 tsconfig.json 的主配置中，tsconfig.app.json 也存在类似问题。该文件中包含了排除测试文件的配置：

"exclude": [
  "src/**/*.spec.ts"
]

在 minimal 模式下，这些测试相关的配置都是不必要的。这反映出 Angular CLI 的模板生成逻辑在 minimal 模式下没有完全过滤掉测试相关的配置项。

解决方案建议

对于 Angular CLI 开发团队，建议在模板生成逻辑中：

1. 为 minimal 模式创建专门的模板子集
2. 确保所有测试相关的配置项都被正确过滤
3. 在 CI 流程中添加 minimal 模式的配置验证

对于开发者，目前可以手动删除这些多余的配置项，或者等待官方修复后升级 CLI 版本。

总结

这个问题虽然不大，但反映了配置生成逻辑中的一处疏漏。Angular 团队通常会对这类问题响应迅速，预计在下一个版本中就会得到修复。开发者在使用新版本 CLI 时，应当注意检查生成的配置文件，特别是当使用特殊标志如 --minimal 时。