首页
/ Eleventy v3.1.0-beta.1 发布:构建性能提升11%,体积缩小22%

Eleventy v3.1.0-beta.1 发布:构建性能提升11%,体积缩小22%

2025-06-02 21:58:37作者:沈韬淼Beryl

Eleventy 是一个简单灵活的静态站点生成器,以其轻量级、高性能和零配置的特性在开发者社区中广受欢迎。它支持多种模板语言,如 Liquid、Nunjucks、Markdown 等,并且不强制要求特定的目录结构,给予了开发者极大的自由度。

版本亮点

最新发布的 Eleventy v3.1.0-beta.1 版本带来了显著的性能优化和新功能:

  1. 构建性能提升:相比 v3.0.0 版本,新版本在构建速度上提升了约11%,模板处理速度更快
  2. 体积缩减:生产依赖从187个减少到142个,安装包大小从27.4MB降至21.4MB,减少了22%
  3. 现代JavaScript支持:新增对Import Attributes语法的支持,允许更安全的JSON导入方式

核心改进

性能优化

新版本通过多项内部重构显著提升了构建速度:

  • 动态开发服务器导入优化,节省约50ms启动时间
  • 合并模板映射与依赖图,实现更精确的增量构建顺序
  • 替换了部分重型依赖项,如用tinyglobby替代fast-glob和is-glob组合

新功能

  1. html-relative 资源复制模式:新增了一种Passthrough Copy模式,专门处理HTML中的相对资源引用
  2. ID属性插件增强:现在可以配置是否检查重复ID,为开发者提供更多灵活性
  3. 错误处理改进:针对各种常见错误场景提供了更清晰的错误信息,包括:
    • 链接到permalink: false模板时的提示
    • 自定义模板类型中非字符串permalink值的错误
    • .11ty.js文件中的语法错误
    • 在Node v22.12中使用require(esm)的兼容性提示

开发者体验

  • 改进了类型定义,增加了UserConfig的子路径导出
  • 增强了开发服务器的稳定性和功能
  • 提升了与各种构建工具和服务器环境的兼容性

重要修复

  1. 集合API修复:解决了addCollection API返回非传统数据时的问题
  2. Windows平台问题:修复了文件删除后重新添加时出现的重复permalink错误
  3. 函数permalink处理:修复了使用函数permalink时的slice错误
  4. 数组合并逻辑:改进了eleventyComputed中数组的合并行为
  5. 日期解析:修复了addDateParsing API中的大小写转换错误

技术细节

依赖项更新

  • 多个核心依赖升级到仅支持Node 18+的版本
  • 移除了rifraf依赖项
  • 升级了liquidjs模板引擎到10.21.0版本
  • 优化了依赖树,减少了不必要的深层依赖

基准测试结果

在Node v22.13.1环境下测试2500个模板的构建速度:

  • Liquid模板:1.3秒(提升10%)
  • Nunjucks模板:1.81秒(提升11%)
  • Markdown模板:1.61秒(提升11%)

升级建议

对于现有项目,可以通过以下命令尝试新版本:

npm install @11ty/eleventy@beta --save-exact

建议在非生产环境中先进行测试,特别是使用了复杂自定义模板或插件的项目。新版本虽然带来了显著的性能提升,但由于包含多项内部重构,可能会影响某些边缘用例的行为。

总体而言,Eleventy v3.1.0-beta.1延续了该项目追求轻量化和高性能的传统,为开发者提供了更快的构建速度和更完善的开发体验。

登录后查看全文
热门项目推荐
相关项目推荐