Rollup插件dynamic-import-vars路径规范化问题解析

在Rollup生态系统中，dynamic-import-vars插件是一个用于处理动态导入变量的重要工具。近期该插件在版本2.1.4中引入了一个关键变更，导致非规范化路径的处理出现了兼容性问题。

问题背景

动态导入是现代JavaScript开发中的常见模式，允许开发者根据运行时条件加载模块。dynamic-import-vars插件通过将动态导入转换为静态导入模式，使得Rollup能够正确分析和打包这些模块。

在最新版本中，插件内部将路径匹配库从fast-glob切换为tinyglobby，这一变更带来了路径规范化行为的差异。具体表现为：当开发者使用包含相对路径符号(如./或../)的非规范化路径时，插件无法正确匹配和解析模块。

技术细节分析

问题的核心在于路径规范化处理的不一致性。举例说明：

import(`./../${myFile}.js`)

在旧版本中，fast-glob会保留原始路径格式，使得运行时匹配能够正常工作。而tinyglobby则会自动将路径规范化，生成的匹配模式变为../*.js，最终解析为../myFile.js。然而在运行时比较时，原始代码中的./../myFile.js与规范化后的../myFile.js无法匹配，导致"Unknown variable dynamic import"错误。

解决方案探讨

开发团队考虑了多种解决方案：

1. 回退变更：最直接的方案是撤销tinyglobby的引入，恢复fast-glob的使用。这能立即解决问题，但放弃了依赖简化的优势。

2. 修改tinyglobby：尝试让tinyglobby提供路径规范化选项。但考虑到tinyglobby的设计理念是保持结果一致性，且其规范化行为是刻意为之，这一方案可行性较低。

3. 运行时路径规范化：在插件生成的运行时代码中，对动态导入路径进行规范化处理。这需要引入额外的路径处理库，但能从根本上解决问题。

经过讨论，团队最终选择了回退变更的方案。虽然这意味着暂时放弃依赖简化的好处，但能确保现有项目的兼容性不受影响。这一决策体现了对稳定性的重视，特别是在临近重要发布(Svelte Summit)的时间节点。

经验总结

这一事件为开发者提供了几个重要启示：

1. 路径处理的一致性至关重要，特别是在模块系统这种基础功能中。

2. 依赖变更需要全面测试，特别是涉及底层行为差异时。

3. 稳定性优先，当面临兼容性风险时，保守的选择往往更稳妥。

对于使用dynamic-import-vars插件的开发者，建议在升级时注意路径写法，或暂时停留在稳定版本，等待更完善的解决方案。这也提醒我们在设计类似功能时，应该考虑各种路径表示形式的兼容性，为开发者提供更灵活的使用方式。