Rushstack项目中API Extractor与TypeScript 5.6.2兼容性问题分析

问题背景

在TypeScript 5.6.2版本升级后，Rushstack项目中的API Extractor工具出现了模块解析失败的问题。具体表现为在处理export type * from这样的类型通配符导入语句时，工具无法正确解析模块路径，导致构建过程中断。

技术细节

问题的根源在于TypeScript 5.6.2内部对模块解析机制的改动。具体来说，TypeScript团队在PR #58825中修改了getModeForUsageLocation函数的实现，现在这个函数需要接收编译器选项(compilerOptions)作为参数。然而API Extractor工具在调用这个内部函数时没有传递这个必要参数。

问题表现

当开发者尝试使用API Extractor分析包含以下类型导入语句的代码时：

export type * from './render/jsx/types/jsx-generated';

工具会抛出错误信息：

Internal Error: getResolvedModule() could not resolve module name "./render/jsx/types/jsx-generated"

解决方案

修复方案相对直接，需要修改API Extractor中两处调用getModeForUsageLocation的地方，将编译器选项作为第三个参数传递：

1. 在ExportAnalyzer.ts文件中，更新函数调用方式
2. 修改TypeScriptInternals.ts中的类型定义和实现

值得注意的是，getModeForUsageLocation实际上是TypeScript的公共API，原本不需要使用类型断言(as any)来调用。如果之前就使用了正确的类型定义，这个问题可能会更早被发现。

影响范围

这个问题影响了所有使用API Extractor工具并计划升级到TypeScript 5.6.2的项目。特别是typescript-eslint项目也报告了相同的问题，表明这是一个相对广泛的影响。

技术建议

对于依赖API Extractor的项目，建议：

1. 等待官方发布包含此修复的新版本
2. 如果需要立即升级TypeScript，可以考虑临时应用补丁
3. 在项目中使用TypeScript公共API而非内部实现，可以提高兼容性

这个问题也提醒我们，当工具深度依赖编译器内部实现时，需要密切关注上游变更，并考虑建立更健壮的测试机制来捕获这类兼容性问题。