tsc增量构建中删除.ts源文件后对应.js文件未清理的问题

在大型项目中尝试用tsc的增量构建（--incremental + --build）加速本地和CI的编译流程，但遇到一个问题：删除.ts源文件后，再次执行增量构建时，对应的.js输出文件不会被自动删除。如果每次构建前都清理整个输出目录，增量构建的提速优势就完全丧失了。

示例场景：
初始文件结构：

.
├── bar.ts
├── foo.ts
├── index.ts
├── package.json
└── tsconfig.json

执行构建命令：

npx tsc --build --incremental ./

构建后文件结构：

.
├── bar.js
├── bar.ts
├── foo.js
├── foo.ts
├── index.js
├── index.ts
├── package.json
├── tsconfig.json
└── tsconfig.tsbuildinfo

删除bar.ts后再次执行相同构建命令，bar.js仍会保留在目录中。

首先明确：TypeScript官方的tsc增量构建本身没有提供自动清理已删除源文件对应输出的CLI参数，这是当前增量构建机制的设计局限——tsconfig.tsbuildinfo仅追踪已存在源文件的编译状态，不会主动检测源文件的删除操作，因此不会触发遗留输出文件的清理。

针对这个问题，有几种可行的解决思路：

• 自定义脚本辅助清理：
  编写简单的Node.js脚本，遍历项目目录，检查每个.js（以及.d.ts、.js.map等）文件是否存在对应的.ts源文件，若不存在则删除该输出文件。例如：

  const fs = require('fs').promises;
  const path = require('path');
  
  async function cleanUnmatchedOutputs(dir) {
    const files = await fs.readdir(dir);
    for (const file of files) {
      const filePath = path.join(dir, file);
      const stats = await fs.stat(filePath);
      if (stats.isDirectory()) continue;
      
      if (file.endsWith('.js') || file.endsWith('.d.ts') || file.endsWith('.js.map')) {
        const sourceFile = filePath.replace(/\.(js|d\.ts|js\.map)$/, '.ts');
        try {
          await fs.access(sourceFile);
        } catch {
          // 源文件不存在，删除输出文件
          await fs.unlink(filePath);
          console.log(`Deleted orphaned file: ${file}`);
        }
      }
    }
  }
  
  cleanUnmatchedOutputs('./').catch(console.error);
  

  可以在增量构建前执行这个脚本，或者把它集成到package.json的scripts中。

• 定期全量清理+增量构建结合：
  本地开发时保持增量构建以提升速度，每周或每月手动执行一次tsc --clean全量清理；CI流程中，可在每日的首次构建时执行全量清理，其余时间使用增量构建，平衡速度和清理需求。

• 分离源文件与输出目录：
  修改tsconfig.json，通过outDir配置将输出文件指定到单独的dist目录，这样可以更精准地清理：编写脚本扫描源文件目录，对比dist目录的输出文件，删除无对应源的文件；或者偶尔直接删除整个dist目录后重新构建，这种方式比清理混合目录更可控。

内容的提问来源于stack exchange，提问作者Filip Seman