何时不应启用TypeScript的incremental tsconfig？官方文档何处可寻？

不适合启用incremental的场景： #

• 小型项目：当项目只有寥寥几个TypeScript文件时，增量编译的缓存读写开销会超过编译本身的耗时，反而拖慢整体编译速度，完全没必要启用。
• 频繁大幅调整项目结构或配置：如果经常批量增删文件、修改tsconfig.json的核心配置（比如include/exclude规则、target/module这类关键编译选项），增量编译的.tsbuildinfo缓存会频繁失效，每次都要触发全量编译，还平白多了缓存管理的额外开销。
• 需要绝对纯净编译环境的场景（如CI/CD流水线）：在持续集成环境中，若要求每次编译都是完全从头开始，避免旧缓存残留导致的编译结果不一致问题，就应该禁用incremental，确保编译结果的可靠性。
• 磁盘空间受限的环境：增量编译会生成.tsbuildinfo缓存文件，虽然单个文件体积不大，但长期积累或在多项目共存的环境下，会占用额外的磁盘空间，对轻量容器、老旧设备这类空间紧张的环境不友好。

官方文档相关说明： #

TypeScript官方手册的Compiler Options章节对incremental配置有详细说明，其中明确该选项是为大型项目优化编译速度设计的，并非适用于所有场景。文档会解释增量编译的缓存工作机制，以及缓存失效时的额外开销，帮助开发者判断是否适合启用该配置。

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