Rollup项目中处理文件名特殊字符%导致URI解析错误的问题分析

在JavaScript模块打包工具Rollup的最新版本中，开发人员发现了一个与文件名特殊字符处理相关的有趣问题。当生成的代码块(chunk)名称中包含百分号(%)时，会导致浏览器在动态导入时抛出"URI malformed"错误。

问题背景

Rollup作为现代前端构建工具，在代码分割和动态导入方面表现优异。然而，当遇到文件名中包含特殊字符%时，系统会生成类似import('./foo%bar-hash.js')的动态导入语句，而不是经过正确编码的import('./foo%25bar-hash.js')形式。

技术原理分析

URI规范要求某些特殊字符必须进行百分号编码。百分号(%)本身在URI中具有特殊含义，它用于表示编码字符的开始(后跟两个十六进制数字)。当文件名中实际包含%字符时，如果不进行编码处理，浏览器会将其误认为是URI编码的一部分，从而导致解析错误。

解决方案演进

Rollup团队在早期版本中已经处理过类似问题(#4222)，当时通过增强sanitizeFileName函数解决了部分特殊字符的问题。这次发现%字符也需要同样的处理方式。

在4.18.1版本中，Rollup团队通过PR #5535修复了这个问题，将%字符添加到默认的文件名清理逻辑中。现在，当文件名中包含%时，Rollup会自动将其转换为安全的形式。

开发者建议

对于使用Rollup的项目，建议开发者：

1. 升级到4.18.1或更高版本以获得此修复
2. 避免在源代码中使用包含%的文件名
3. 了解Rollup的文件名清理机制，必要时可以自定义sanitizeFileName函数

总结

这个案例展示了构建工具在处理边缘情况时的重要性。Rollup团队对这类问题的快速响应体现了该项目的成熟度和对开发者体验的关注。通过不断完善特殊字符处理逻辑，Rollup确保了在各种场景下的稳定性和兼容性。