Rolldown构建工具中文件路径后缀解析问题解析

在Rolldown构建工具的最新版本中，开发者遇到了一个关于文件路径后缀解析的技术问题。该问题主要影响使用Tanstack Router框架并启用了自动代码分割功能的项目。

问题背景

当开发者在Rolldown配置中启用原生插件支持(enableNativePlugins: true)时，构建过程会抛出特定错误。错误信息表明工具无法正确识别带有查询参数的文件路径中的文件类型。例如，对于路径/users.tsx?tsr-split=component，Rolldown无法正确识别其应为TypeScript JSX(.tsx)文件，而是尝试将整个字符串作为文件扩展名处理。

技术细节

这个问题源于Rolldown的文件类型检测机制。在构建过程中，工具需要根据文件扩展名确定如何转换文件内容。当文件路径包含查询参数时(如?tsr-split=component)，现有的解析逻辑未能正确处理这种情况，导致无法提取出真实的文件扩展名。

这种带查询参数的文件路径在Tanstack Router框架中很常见，特别是当开发者启用了自动代码分割功能(autoCodeSplitting: true)时。该功能会为路由组件文件添加?tsr-split=component后缀，以实现更精细的代码分割和按需加载。

解决方案

Rolldown团队已经在新版本中修复了这个问题。开发者可以升级到修复版本，该版本改进了文件路径解析逻辑，能够正确识别带有查询参数的文件扩展名。

对于暂时无法升级的项目，开发者可以考虑以下临时解决方案：

1. 在Tanstack Router配置中暂时禁用自动代码分割功能
2. 在Rolldown配置中显式指定文件转换选项(transformOptions.lang)

最佳实践

为了避免类似问题，建议开发者：

1. 保持构建工具和插件的最新版本
2. 在项目中使用标准文件扩展名
3. 对于特殊用例，提前测试构建工具的支持情况
4. 关注构建工具和框架的兼容性说明

这个问题展示了现代前端构建工具在处理复杂场景时面临的挑战，也体现了开源社区快速响应和解决问题的能力。