更新日志 发布于 2026-11-15

xfmpress v0.4.13:写入阶段提速,重复构建从 5.3 秒降到 0.9 秒

2 分钟阅读 # xfmpress# 更新日志

v0.4.13 的故事始于一次不起眼的 profiling:在千页站点上统计文件系统调用,结果发现写入阶段存在两处纯粹的浪费——大量注定失败的系统调用,和对内容完全没变仍被重写的文件。修复后,千页站点的重复构建写入阶段从 5.3 秒降到 0.9 秒,冷构建(删除 dist 后的首次构建)耗时不变。

这一版在解决什么

重复构建才是日常:改一个字,重写一千个页面。旧版每轮构建都把所有页面刷到磁盘(约 1.5 秒)、为它们 mkdir 目录(约 1.1 秒)——哪怕字节完全相同;pruneStale 还会对 dist 里的每个目录尝试 rmdir,一千个页面目录就是一千次注定失败的 rmdir,在 NTFS 上顺序执行约耗时 3.3 秒。这些浪费叠加起来,就是你每次保存后等待的那几秒。

变了什么

Fixed

  • pruneStale 的空目录清扫改为按需执行。一个目录只有在其内部文件被删除后才可能变空,所以 rmdir 清扫现在只在确实发生了删除时运行,且只遍历被删文件的祖先目录(按最深的先来、并行执行)。没有删除发生时,一次 rmdir 都不会调用。
  • 未变化的页面不再重写。输出文件现在逐个比较(先比大小,再比内容),已经一致就跳过;被跳过的文件连目录都不需要建。资源文件用同样的思路配合 make 规则(大小相等且目标不旧于源文件即跳过),大图片不再被读取。

Added

  • xfm build 会在跳过文件时报告 未变化 N 个文件(内容一致,未重写),让你知道这次构建到底写了多少东西。
  • bench/bench.js 现在把冷构建(删除 dist)和重复构建分开报告,不再混进同一个中位数——毕竟两者的成本结构完全不同。

升级要不要动手

不需要改任何配置,升上去即享受提速。行为上唯一可能注意到的差异是:重复构建变快了,且输出里多了一行「未变化」的统计。如果你的 CI 每次都从干净的 dist 开始,那次这条优化对你帮助不大(冷构建耗时不变);对本地写作循环而言,保存到预览的等待时间会明显缩短。日常构建的用法见 快速上手。

评论