Rollup插件commonjs中动态引入外部路径问题的分析与解决

问题背景

在Rollup构建工具生态中，@rollup/plugin-commonjs插件扮演着重要角色，它负责将CommonJS模块转换为ES模块以便Rollup能够处理。近期版本升级到v28后，用户发现了一个关于动态引入路径的重要功能变化。

问题现象

当开发者尝试在dynamicRequireTargets配置中使用项目根目录之外的路径时（例如../上级目录中的文件），构建过程虽然能完成，但运行时会出现"MODULE_NOT_FOUND"错误。这与v27版本的行为形成了鲜明对比，在旧版本中相同配置可以正常工作。

技术分析

深入探究问题根源，发现这是由于插件内部依赖从glob切换到了fdir所致。fdir作为文件遍历工具，其工作方式与glob有显著差异：

1. 路径解析范围：fdir默认只会在当前工作目录(cwd)内进行文件搜索，而glob则支持更灵活的路径模式匹配
2. 配置选项：fdir缺乏直接支持指定搜索根目录的选项，导致无法像之前那样自由地包含项目其他位置的模块

这种底层依赖变更带来的行为差异，在插件升级说明中可能未被充分强调，导致开发者遇到预期之外的问题。

解决方案

针对这一问题，技术社区提出了几种解决思路：

1. 版本回退：临时解决方案是回退到v27版本，但这只是权宜之计
2. 路径调整：将所有需要动态引入的模块移动到构建目录内
3. 插件修改：最根本的解决方案是增强插件功能，允许指定搜索根目录

在技术实现层面，核心修改点在于动态模块加载部分的代码。通过在crawl()函数调用时增加rootDir参数选项，可以恢复对外部路径的支持能力。例如，当需要包含上级目录时，只需配置crawl('..')即可。

最佳实践建议

对于面临类似问题的开发者，建议：

1. 版本升级时：仔细检查依赖变更日志，特别是底层工具的切换
2. 路径设计时：尽量保持模块引用在项目相对路径范围内
3. 问题排查时：对比新旧版本行为差异，定位变更源头

该问题的PR已经提交，待合并后将彻底解决这一兼容性问题。在此之前，开发者可以根据项目实际情况选择上述临时解决方案。