New Hot

esbuild 0.28.2 发布:修复 TypeScript 导入别名导致的 tree shaking 错误

esbuild构建工具前端压缩版本更新

esbuild 0.28.2 发布,修复 TypeScript 导入别名被错误 tree shaking、CSS 压缩误删 & 选择器、顶层 await 循环依赖生成错误代码等问题,并新增对 TypeScript 7 有歧义类型断言的警告。使用 esbuild 做构建或压缩的项目建议升级。

esbuild 0.28.2 修复 TypeScript 导入别名被误 tree shaking

esbuild 0.28.2 是一次集中修 bug 的补丁版本,覆盖 tree shaking、CSS 压缩、顶层 await 与 JS API 稳定性。

导入别名不再被误删

受影响代码使用 TypeScript 专有的导入赋值写法,例如 import Alias = Base.SomeType。此前这类引用可能被错误地 tree shaking 掉,导致运行时缺少依赖。官方原文称:“This release fixes a bug that could cause esbuild to incorrectly tree-shake imports that are used in a TypeScript type alias under certain circumstances.”(来源:esbuild 官方发布说明)

默认不覆盖输入文件

把 --outfile 指向输入文件时,esbuild 本应默认拒绝,但这一行为在 0.17.0 意外回退,错误信息打印后文件仍被覆盖。这版恢复原行为:除非显式传入 --allow-overwrite,否则不写任何文件。

生成代码与压缩修复

顶层 await 出现在循环依赖中时,模块包装函数可能缺少 async,这版改用不动点迭代算法标注依赖。逻辑赋值运算符降级时重复使用左侧标识符导致的压缩错误也已修复。此外还修了 JS API 的错误引用计数引发的死锁、重复 target 取最小版本、.mp3 的 MIME 类型识别与 CSS 色域回退颜色。

打包结果更可靠并新增 TypeScript 7 语法警告

用 esbuild 做生产压缩或通过 JS API 集成的项目受益最大,尤其是处理 TypeScript 与 CSS 的链路。

打包结果更可靠

误删导入与生成带语法错误的代码都会直接变成线上故障,这两类修复降低了隐蔽问题出现的概率。从官方描述看,改动集中在边界场景,常规项目产物不变。

新增语法警告

TypeScript 7 把“类型断言后直接跟运算符”的写法变成语法错误,esbuild 现在会提示 confusing-typescript-cast。这和 TypeScript 7.0 的语法收紧 是同一条迁移线索,可以用警告提前清理代码。

集成方式更灵活

新增的 --log-style=visualstudio 让 esbuild 作为 MSBuild 自定义构建步骤时日志能正确显示。与 Vite 8.3.8 的补丁修复 一样,这类改动不改配置即可获得。

升级 0.28.2 后对比产物哈希与运行时行为

用 esbuild 做生产构建、压缩或通过 JS API 调用的项目,建议升级到 0.28.2。

怎么升级

把 esbuild 依赖升到 0.28.2 即可,本次是补丁版本,没有列出破坏性变更。升级后确认构建脚本没有依赖“覆盖输入文件”的旧行为。

验证与回退

建议对比升级前后的产物哈希与运行时行为,重点检查使用导入别名的 TypeScript 文件与含顶层 await 的循环依赖模块。官方未披露回退步骤。

常见问题

esbuild 0.28.2 修复了哪个 tree shaking 问题?
TypeScript 导入别名里引用的导入会被错误移除,现在这类引用会被正确保留。
esbuild 0.28.2 会覆盖输入文件吗?
默认不会。只有显式加上 --allow-overwrite 才允许把输出写到输入文件上。
esbuild 0.28.2 新增了什么警告?
对类型断言后直接跟运算符的写法给出警告,因为该语法在 TypeScript 7 及以后会报错。
esbuild 0.28.2 的 CSS 压缩修复了什么?
修复了在不安全的情况下误删 & 选择器的问题,也修正了超出 sRGB 色域时的回退颜色。

相关术语

esbuild
esbuild 是用 Go 编写的前端构建与压缩工具,以启动快和打包速度快著称。
tree shaking
tree shaking 是移除未被使用代码的优化手段,依赖对模块引用关系的准确分析。
顶层 await
顶层 await 是允许在模块最外层直接等待异步结果的语言特性。
source map
source map 是记录产物与源码位置对应关系的文件,用于调试压缩后的代码。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

「esbuild 0.28.2」 —— esbuild

搜索文章

输入关键词,快速查找标题和正文内容。