Eleventy 3.0 Alpha版本中addTemplateFormats方法参数变更解析

在Eleventy 3.0的Alpha版本迭代过程中，开发者需要注意一个重要的API变更：addTemplateFormats方法不再支持数组作为参数传入。这一变动从Alpha 7版本开始引入，导致部分现有代码出现兼容性问题。

问题背景

addTemplateFormats是Eleventy中用于注册自定义模板格式的方法。在Alpha 6及之前版本中，该方法可以接受数组参数，允许开发者一次性添加多个模板格式：

eleventyConfig.addTemplateFormats(["txt", "text"])

然而从Alpha 7版本开始，这一用法会导致运行时错误，系统会抛出"entry.trim is not a function"异常。这是因为内部实现发生了变化，不再对数组参数进行特殊处理。

技术细节分析

通过查看错误堆栈可以发现，问题出在ProjectTemplateFormats.js文件的第28行。新版本中该方法期望每个输入都是字符串类型，会直接调用trim()方法进行处理。当传入数组时，由于数组没有trim方法，自然就会抛出类型错误。

解决方案

对于需要使用新版本的用户，目前有两种解决方案：

1. 逐个添加模板格式：

eleventyConfig.addTemplateFormats("txt");
eleventyConfig.addTemplateFormats("text");

2. 等待Alpha 10版本： 开发团队已经确认将在Alpha 10版本中修复这个问题，恢复对数组参数的支持。

版本兼容性建议

对于正在开发中的项目，建议：

1. 如果已经升级到Alpha 7+版本，暂时采用逐个添加的方式
2. 如果还在使用Alpha 6，可以保持现状等待稳定版
3. 密切关注Alpha 10的发布公告

总结

这个案例很好地展示了在框架升级过程中可能遇到的API变更问题。作为开发者，我们需要：

• 仔细阅读每个版本的变更日志
• 为重要升级准备回滚方案
• 在测试环境中充分验证新版本

Eleventy团队对这类问题的快速响应也值得赞赏，展现了开源项目维护的良好实践。随着3.0正式版的临近，相信这类过渡期问题会得到妥善解决。