Eleventy 3.0 版本中模板别名格式的显式声明要求

在静态站点生成器Eleventy的3.0版本更新中，团队对模板语言的别名机制进行了重要调整。这项变更主要影响开发者通过addExtension方法为现有模板语言创建别名的使用方式。

在先前版本中，当开发者使用如下代码为Markdown文件创建别名时：

eleventyConfig.addExtension("markdown", {
    key: "md",
});

系统会自动将.markdown扩展名的文件纳入处理流程，只要md格式已被包含在项目模板格式配置中。这种隐式关联虽然方便，但随着Eleventy 3.0支持更复杂的别名机制，这种自动关联行为被调整为需要显式声明。

新版本要求开发者必须通过以下两种方式之一明确声明：

1. 在命令行参数中指定：--formats=markdown
2. 或在配置文件中调用：eleventyConfig.addTemplateFormats("markdown")

这项变更的背景是Eleventy正在扩展对复杂模板类型的支持，特别是围绕11ty.js衍生的多种变体（如11ty.tsx、11ty.jsx、11ty.ts等）。通过要求显式声明，系统能够更精确地控制模板处理流程，避免潜在的命名冲突和歧义。

对于开发者而言，这意味着：

1. 升级到3.0版本后，现有的别名配置可能需要额外添加格式声明
2. 项目构建时如果发现某些模板文件未被处理，需要检查是否遗漏了格式声明
3. 新的显式声明机制为更复杂的模板类型组合提供了更好的支持

这项改进虽然带来了短暂的适配成本，但从长远来看提高了项目的可维护性和扩展性，特别是对于使用多种模板语言混合开发的大型项目。