TypeScript项目中.mts文件导入.mjs模块的路径解析问题解析

问题背景

在TypeScript 5.7版本中，开发者遇到了一个关于模块导入路径解析的特殊问题。当在.mts(TypeScript模块)文件中尝试导入.mjs(JavaScript模块)文件时，TypeScript编译器会报出TS2876错误，提示"这个相对导入路径不安全，无法重写"。

技术细节分析

这个问题出现在TypeScript的模块解析系统中，特别是当启用了rewriteRelativeImportExtensions编译选项时。这个选项的设计初衷是让TypeScript自动处理模块导入路径中的文件扩展名，但在处理.mts导入.mjs这种跨类型模块导入时出现了判断失误。

关键点在于：

1. .mts文件是TypeScript的模块格式文件
2. .mjs文件是JavaScript的模块格式文件
3. 当两者在同一个项目中共存时，TypeScript的路径解析逻辑出现了边界情况处理不足

问题复现条件

要复现这个问题，需要满足以下配置：

1. 使用TypeScript 5.7或更高版本
2. 在tsconfig.json中启用rewriteRelativeImportExtensions选项
3. 项目设置为NodeNext模块系统
4. 存在.mts文件尝试导入.mjs文件的情况

解决方案与变通方法

目前TypeScript团队已经确认这是一个bug并提供了修复方案。在等待正式修复发布的过渡期，开发者可以采用以下临时解决方案：

1. 暂时禁用rewriteRelativeImportExtensions选项
2. 使用完整的导入路径，包括文件扩展名
3. 将.mjs文件重命名为.mts文件（如果可行）
4. 使用动态导入方式替代静态导入

技术原理深入

这个问题的根源在于TypeScript的模块解析系统在处理不同模块类型时的安全机制。当启用rewriteRelativeImportExtensions时，编译器会尝试重写导入路径以确保最终生成的JavaScript代码使用正确的模块扩展名。但在处理.mts→.mjs这种跨类型导入时，安全机制错误地将合法的导入路径标记为"不安全"。

最佳实践建议

对于混合使用TypeScript和JavaScript模块的项目，建议：

1. 保持模块类型一致，尽量统一使用.mts或.mjs
2. 如果必须混用，考虑使用明确的导入映射
3. 关注TypeScript的更新日志，及时获取关于此问题的修复信息
4. 在关键项目中进行充分的路径解析测试

总结

TypeScript作为JavaScript的超集，在处理现代JavaScript模块系统时偶尔会遇到边界情况。这个.mts导入.mjs的问题展示了模块解析系统中的一个特定场景缺陷。理解这类问题的本质有助于开发者在遇到类似情况时更快地定位和解决问题，同时也提醒我们在采用新特性时要进行充分的兼容性测试。