Rolldown项目中的WASI与原生环境下的Hook Filter差异分析

在Rolldown项目的开发过程中，我们发现了一个关于Hook Filter在不同运行环境下行为不一致的问题。这个问题特别出现在WASI(WebAssembly System Interface)环境下，与原生Node.js环境相比，Hook Filter的表现存在明显差异。

问题现象

在构建过程中，当使用WASI环境时，Hook Filter无法正确匹配模块ID，导致构建失败。具体表现为：

1. 在原生Node.js环境下，Hook Filter能够正确识别并处理virtual:foo这样的虚拟模块
2. 在WASI环境下，相同的配置却无法匹配到该模块，导致构建失败

根本原因分析

经过深入调查，我们发现问题的根源在于路径处理方式的差异：

1. 当前工作目录的差异：WASI环境下获取的当前工作目录(get_current_dir)返回的是根目录/，而原生环境下返回的是实际的项目路径
2. 路径稳定化处理：在匹配过程中，系统会对模块ID进行稳定化处理(路径相对化)，这在不同环境下产生了不同的结果
   • 原生环境：virtual:foo → virtual:foo
   • WASI环境：virtual:foo → ../../../../../../../virtual:foo
3. Glob匹配失效：由于稳定化后的路径不同，导致基于Glob的模式匹配在WASI环境下失败

技术背景

Hook Filter是Rollup/Rolldown插件系统中用于精确控制插件执行范围的重要机制。它允许开发者通过字符串模式或正则表达式来指定哪些模块应该被特定插件处理。这种机制来源于Rollup生态中的pluginutils工具库。

在实现上，Filter通常支持以下几种匹配方式：

• 字符串模式(支持Glob语法)
• 正则表达式
• 自定义函数

解决方案

针对这个问题，Rolldown团队采取了以下措施：

1. 统一路径处理逻辑：确保在不同环境下使用相同的路径处理方式
2. 改进Filter匹配机制：考虑直接使用原始ID进行匹配，避免路径稳定化带来的副作用
3. 环境适配：针对WASI环境的特殊性进行适配处理

开发者建议

对于使用Rolldown的开发者，在处理类似问题时可以注意以下几点：

1. 在定义Hook Filter时，尽量使用明确的匹配模式
2. 对于虚拟模块，考虑使用更精确的匹配方式(如正则表达式)
3. 在不同环境下测试插件行为，确保一致性
4. 关注Rolldown的更新，及时获取针对WASI环境的优化

这个问题不仅揭示了WASI环境下路径处理的特殊性，也提醒我们在跨环境开发时需要更加注意系统接口的行为差异。Rolldown团队通过这个问题进一步优化了项目的跨平台兼容性，为未来的WASM/WASI支持奠定了更好的基础。