Rollup.js 中默认导出与命名空间导出的兼容性问题解析

在JavaScript模块打包工具Rollup.js的最新版本4.14.1中，开发者发现了一个关于CommonJS输出格式的导出兼容性问题。这个问题主要出现在同时使用默认导出和命名空间导出的场景中。

问题现象

当开发者尝试以下代码结构时：

export * from '@redux-saga/core'
import createSagaMiddleware from '@redux-saga/core'
export default createSagaMiddleware

Rollup生成的CommonJS输出代码中会出现一个未声明的变量引用createSagaMiddleware__namespace。这个变量在代码中从未被定义，却在使用时被引用，导致运行时错误。

技术背景

在Rollup的模块系统中，当启用interop: compat或interop: auto选项时，处理默认导出会涉及特殊的转换逻辑。这些选项主要用于确保ES模块和CommonJS模块之间的互操作性。

在正常情况下，Rollup应该：

1. 为导入的模块创建命名空间对象
2. 正确处理默认导出的兼容性包装
3. 确保所有导出引用都指向有效的变量

问题根源

这个问题的根本原因在于Rollup的代码生成阶段没有正确处理以下情况：

• 当同时存在命名空间导出(export *)和默认导出时
• 在CommonJS输出格式下
• 启用了模块互操作(interop)功能

在这种情况下，Rollup错误地生成了对__namespace后缀变量的引用，而实际上应该直接使用原始导入的变量名。

解决方案

Rollup团队在4.14.2版本中修复了这个问题。修复后的代码会正确生成变量引用，不再出现未声明的命名空间变量。

对于开发者来说，如果遇到类似问题，可以：

1. 升级到最新版本的Rollup
2. 检查导出语句的结构，避免过于复杂的导出组合
3. 在必要时显式声明命名空间，而不是依赖自动转换

最佳实践

在使用Rollup处理模块导出时，建议：

• 明确区分默认导出和命名导出
• 对于复杂的导出场景，考虑拆分到不同文件
• 定期更新Rollup版本以获取最新的兼容性修复
• 在构建配置中明确指定互操作行为，而不是依赖默认值

这个问题的修复体现了Rollup团队对模块系统兼容性的持续改进，也提醒开发者在处理模块导出时要特别注意不同模块格式间的转换细节。