SWC项目中多扩展名文件路径解析问题分析

SWC作为一款高性能的JavaScript/TypeScript编译器，在路径解析方面存在一个值得注意的问题。当使用路径别名(alias)功能时，如果目标文件包含多个点号(.)，会导致解析结果不正确。

问题现象

在NestJS等项目中，开发者经常会使用类似foo-bar.decorator.ts这样的文件名。当通过路径别名引用这类文件时，SWC的解析结果会出现偏差。例如配置了路径别名@decorator/foo-bar指向src/common/decorators/foo-bar.decorator.ts，但实际解析结果会错误地截断到第一个点号后的部分。

技术原因

问题的根源在于SWC的路径解析逻辑中使用了split_once方法。这个方法会在第一个点号处分割字符串，导致对于foo-bar.decorator.ts这样的文件名，只会保留foo-bar部分，而正确的做法应该是从最后一个点号处分割。

Rust标准库中的split_once和rsplit_once方法区别在于：

• split_once: 从字符串开头查找第一个匹配的分隔符
• rsplit_once: 从字符串末尾查找第一个匹配的分隔符

解决方案

对于包含多个点号的文件路径，应该使用rsplit_once替代split_once，这样可以确保正确识别文件扩展名。修改后的行为将：

1. 对于foo-bar.decorator.ts，正确识别基础文件名为foo-bar.decorator
2. 保持与TypeScript官方编译器(tsc)一致的行为
3. 不影响普通单点号文件名的解析

影响范围

该问题主要影响以下场景：

1. 使用路径别名功能
2. 目标文件名包含多个点号
3. 配置中启用了resolveFully选项

对于常规的单点号文件名(如index.ts)，解析行为不受影响。

最佳实践

在SWC修复该问题前，开发者可以采取以下临时方案：

1. 避免在文件名中使用多个点号
2. 使用统一的命名规范，如全部使用连字符(-)代替额外点号
3. 对于必须使用多扩展名的场景，考虑使用完整相对路径引用

总结

路径解析是构建工具的核心功能之一，正确处理各种文件名格式对于保证项目构建可靠性至关重要。SWC作为新兴的构建工具，在性能方面表现出色，但在边缘场景的处理上仍有改进空间。开发者在使用时应注意这类特殊情况，合理规划项目文件命名规范。