OpenTiny引擎控制器模块打包路径问题解析

问题背景

在OpenTiny项目开发过程中，开发人员在使用tiny-engine-controller模块进行打包构建时遇到了路径配置问题。该问题主要出现在Rollup打包工具的entryFileNames配置环节，系统提示"./js/completion.js"是一个无效的路径模式。

问题现象

当执行pnpm build:plugin命令对controller模块进行打包时，构建过程会抛出错误信息："Invalid pattern './js/completion.js' for 'output.entryFileNames'"。错误明确指出，在output.entryFileNames配置中不能使用绝对路径或相对路径作为模式。

技术分析

Rollup打包配置限制

Rollup对entryFileNames配置有明确的路径格式要求：

1. 不能包含绝对路径
2. 不能包含相对路径(如./或../)
3. 如果需要将文件输出到子目录，应该直接使用"subdirectory/pattern"格式

问题根源

在tiny-engine-controller的打包配置中，开发者尝试使用"./js/xxx.js"这样的相对路径格式来指定输出文件的位置，这违反了Rollup的配置规则。

解决方案

经过分析，可以采用以下方式解决：

1. 修改入口文件收集逻辑：

const jsEntries = glob.sync('./js/**/*.js').map((file) => {
  return [file.slice(5, file.length - path.extname(file).length), fileURLToPath(new URL(file, import.meta.url))]
})

2. 调整fileName配置策略：

fileName: (format, entryName) => {
  if (entryName in Object.fromEntries(jsEntries)) {
    return `js/${entryName}.js`;  // 动态入口放在js子目录
  }
  return `${entryName}.js`;  // 静态入口放在根目录
}

最佳实践建议

1. 路径处理：在Rollup配置中，应避免使用任何形式的相对路径标识符(./或../)

2. 动态入口管理：对于需要特殊处理的动态入口文件，建议使用映射表的方式进行管理，而不是依赖路径模式

3. 构建工具兼容性：不同构建工具对路径格式的要求可能不同，开发时应仔细阅读相关文档

4. 环境适配：考虑不同操作系统对路径处理的差异，建议使用path模块进行跨平台兼容处理

总结

OpenTiny引擎控制器模块的打包路径问题是一个典型的构建工具配置问题。通过理解Rollup对路径模式的限制，并采用正确的配置方式，可以有效解决这类构建错误。开发者在处理类似问题时，应当仔细阅读构建工具的文档，理解其配置规则，避免因格式问题导致的构建失败。