TypeStat项目中include配置解析问题的分析与解决

问题背景

在TypeStat项目中，当使用include配置项来指定需要处理的文件时，发现实际匹配到的文件数量远少于预期。具体表现为：配置中明明指定了['src', 'test/*.ts']，但最终只匹配到了test目录下的部分TypeScript测试文件，而src目录下的文件完全未被包含。

问题表现

开发者在调试过程中发现，虽然parseRawCompilerOptions正确读取了include配置，但在后续处理中，parseJsonConfigFileContent.filenames方法返回的文件列表却大大缩减，仅包含部分测试文件：

test/postProcessing.test.ts
test/infiniteWaveDetection.test.ts
test/include.test.ts
...

技术分析

这个问题涉及到TypeScript编译器API中配置文件解析的机制。TypeStat项目使用TypeScript的parseJsonConfigFileContent方法来处理tsconfig.json中的配置项，但默认行为可能无法正确处理包含多个目录的include模式。

解决方案

经过调试，发现可以通过修改配置解析逻辑来正确获取所有匹配文件。关键修改点在于确保parseJsonConfigFileContent方法能够正确处理include数组中的多个模式。修改后的代码逻辑如下：

config.include &&= ts.parseJsonConfigFileContent(
    compilerOptions.config,
    {
        fileExists: fs.existsSync,
        readDirectory: ts.sys.readDirectory,
        readFile: (file) => fs.readFileSync(file, "utf8"),
        useCaseSensitiveFileNames: true,
    },
    cwd,
).fileNames;

这个修改确保了：

1. 使用正确的文件系统操作方法
2. 保持文件名大小写敏感性
3. 正确处理多个包含模式

后续问题

虽然这个修改解决了文件收集不全的问题，但开发者发现项目中仍然存在另一个问题：TypeStat会添加大量不必要的ts-expect-error注释。这表明文件收集问题只是整个问题链中的一环，还需要进一步优化类型错误检测逻辑。

总结

这个问题的解决过程展示了TypeScript配置解析的复杂性，特别是在处理多目录包含模式时。对于类似工具的开发，需要注意：

1. TypeScript编译器API的配置解析行为可能与预期不同
2. 文件系统操作方法的正确选择至关重要
3. 多模式匹配需要特别处理

该问题的修复最终通过PR#2056完成，为TypeStat项目的文件收集功能提供了更可靠的基础。