Eleventy 3.0.0 配置文件中多导出问题的分析与解决

在 Eleventy 3.0.0 版本升级过程中，开发者可能会遇到一个关于配置文件导出的特殊问题。当在 eleventy.config.js 文件中除了默认导出外还包含其他导出时，会导致配置设置被意外重置为默认值。

问题现象

当开发者尝试在 Eleventy 配置文件中同时导出多个项目时，例如：

export default function(eleventyConfig) {
  // 配置内容
}

export const someVariable = 'value';

这种情况下，Eleventy 会忽略配置文件中的所有设置，包括输入/输出目录等关键配置项，转而使用默认值。具体表现为：

• 输出目录自动变为默认的 _site 而非配置中指定的目录
• 其他自定义配置项也会被忽略

技术背景

Eleventy 3.0.0 版本对模块系统进行了重大更新，采用了更现代的 ESM (ECMAScript Modules) 标准。在模块解析过程中，Eleventy 会专门查找配置文件中的默认导出作为配置函数。当存在其他命名导出时，可能会导致模块解析逻辑出现偏差。

解决方案

经过 Eleventy 开发团队的修复，在 3.0.0-alpha.9 及更高版本中，这个问题已经得到解决。现在开发者可以安全地在配置文件中导出多个项目：

1. 确保使用正确的默认导出语法：

export default function(eleventyConfig) {
  // 主配置内容
}

2. 可以自由添加其他命名导出：

export const helperFunction = () => {
  // 辅助函数
};

export const constants = {
  // 常量定义
};

3. 避免使用与配置相关的保留名称（如 config）作为命名导出

最佳实践

对于需要在多个文件中共享的配置或工具函数，建议：

1. 将主要配置保留在 eleventy.config.js 的默认导出中
2. 将辅助函数和常量提取到单独的模块文件中
3. 使用清晰的命名约定区分不同类型的导出

升级建议

如果项目正在从 Eleventy 2.x 升级到 3.0.0，建议：

1. 首先确保配置文件使用正确的 ESM 语法
2. 逐步测试各项配置功能
3. 更新到最新稳定版以获得最佳兼容性

通过遵循这些指导原则，开发者可以充分利用 Eleventy 3.0.0 的新特性，同时避免配置导出带来的意外行为。