Rolldown构建工具中关于模块导出的问题解析

问题背景

在使用Rolldown构建工具打包项目时，开发者可能会遇到一个常见的错误提示："default" is not exported by...。这种情况通常发生在处理某些第三方库时，特别是当这些库的打包配置存在特殊字段时。

问题本质

这个问题的核心在于模块解析策略。当Rolldown尝试解析roughjs库时，它会按照特定的顺序查找入口文件。在roughjs@4.5.2版本中，package.json包含了三个关键字段：

• browser字段
• module字段
• main字段

Rolldown的默认行为是：如果未明确指定平台(platform)且输出格式(format)不是CommonJS(cjs)，则会默认使用browser平台。在解析模块时，它会按照[browser, module, main]的顺序查找入口文件。

问题根源

在roughjs@4.5.2版本中，browser字段指向的bundled/rough.js文件实际上并没有提供默认导出(default export)，而项目代码中却尝试以默认导入的方式使用它，这就导致了构建错误。

解决方案

开发者可以采取以下两种解决方案：

1. 升级依赖版本： 升级到roughjs@4.6.6或更高版本，这些版本已经移除了browser字段，避免了模块解析时的冲突问题。

2. 调整解析配置： 如果必须使用4.5.2版本，可以在Rolldown配置中明确指定解析的主字段顺序：

   resolve: {
     mainFields: ['module', 'main'],
   }
   

   这样配置会跳过browser字段，直接使用module或main字段指向的入口文件。

技术建议

对于构建工具的使用，建议开发者：

1. 了解项目中重要依赖的package.json结构
2. 熟悉构建工具的解析策略和默认行为
3. 遇到类似问题时，首先检查依赖版本和构建配置
4. 保持关键依赖更新到最新稳定版本

通过理解模块解析机制和构建工具的工作原理，开发者可以更高效地解决这类构建时的问题。