首页
/ tsdown v0.11.0-beta.1 版本发布:构建工具的重大升级

tsdown v0.11.0-beta.1 版本发布:构建工具的重大升级

2025-07-01 01:51:59作者:蔡怀权

tsdown 是一个基于 Rollup 的 TypeScript 构建工具,它简化了 TypeScript 项目的打包流程,提供了开箱即用的配置和优化。最新发布的 v0.11.0-beta.1 版本带来了多项重要更新和改进,本文将详细介绍这些变化。

重大变更

Node.js 版本要求提升

本次更新最显著的变化是提高了对 Node.js 版本的要求。现在 tsdown 需要 Node.js v20.11.0 或更高版本,同时不再支持 Node.js 18。这一变更反映了现代 JavaScript 生态系统的演进趋势,允许开发者使用最新的 Node.js 特性和性能优化。

依赖关系调整

另一个重要变化是将 unplugin-lightningcss 从直接依赖改为 peer 依赖。这意味着项目需要显式声明对 unplugin-lightningcss 的依赖,这为开发者提供了更大的灵活性,可以根据项目需求选择特定版本的 CSS 处理工具。

新功能亮点

移除 Node 协议支持

新增的 removeNodeProtocol 选项允许开发者在构建过程中自动移除 node: 协议前缀。这个特性特别适用于需要兼容不支持 Node.js 协议前缀的环境,或者需要将代码运行在浏览器等非 Node.js 环境中的场景。

资源复制与公共目录

新版本引入了 copypublicDir 两个选项,极大地简化了静态资源的管理:

  • copy 选项可以配置需要复制的文件或目录
  • publicDir 选项指定公共目录的位置

这些功能使得处理项目中的静态资源(如图片、字体等)变得更加简单和直观。

自动目标检测

tsdown 现在能够自动解析 package.json 中的 engines.node 字段,并将其作为默认的构建目标。这一智能特性减少了配置的复杂性,同时确保了构建输出与项目声明的 Node.js 版本要求保持一致。

CLI 增强

命令行界面新增了 tsconfig 选项,允许开发者指定自定义的 TypeScript 配置文件路径。这为大型项目或多配置环境提供了更大的灵活性。

技术影响与建议

这次更新标志着 tsdown 向更现代化、更灵活的构建工具迈进。对于现有项目,升级时需要注意以下几点:

  1. 首先确保开发环境和生产环境都运行在 Node.js v20.11.0 或更高版本
  2. 如果项目使用了 CSS 处理功能,需要显式添加 unplugin-lightningcss 依赖
  3. 可以利用新的资源管理功能简化构建配置
  4. 考虑使用自动目标检测来简化配置

对于新项目,建议直接采用这个 beta 版本,以利用所有最新功能和优化。虽然处于 beta 阶段,但这些变更已经经过充分测试,可以满足大多数生产环境的需求。

总的来说,tsdown v0.11.0-beta.1 通过提高最低要求、增加新功能和优化现有特性,为 TypeScript 项目构建提供了更强大、更灵活的解决方案。

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