用途:tsdown 是面向 TypeScript 与 JavaScript 库的打包器,动力来自 Rolldown 和 Oxc,定位为“优雅的库打包器”。它适用于为 npm 构建 TypeScript/JavaScript 库、生成 TypeScript 声明文件、按多种格式(ESM、CJS、IIFE、UMD)打包、进行 tree shaking 与压缩,以及从 tsup 迁移,也适用于构建 React、Vue、Solid、Svelte 组件库。
主要能力:支持入口点配置(含 glob 与排除模式)、输出格式、输出目录与扩展名、类型声明(dts,含 sourcemap、compilerOptions、vue 选项)、目标环境与平台、tree shaking、压缩、source map、watch、清理、日志级别。依赖处理包括 external、noExternal 与自动外部化 peer/依赖。输出增强包括 shims、cjsDefault、自动生成 package.json exports、实验性 CSS 处理、unbundle 目录结构保留、publint 与 attw 包校验。还支持 Rolldown/Rollup/Unplugin 插件、生命周期钩子与编程式 API,并可直传 Rolldown 选项;支持 CI 环境检测及 ci-only/local-only 取值。框架与运行时方面提供 React、Vue、WASM 的配方说明。
使用方式:安装命令为 pnpm add -D tsdown。基本运行 npx tsdown;指定配置 npx tsdown --config tsdown.config.ts;监听模式 npx tsdown --watch;从 tsup 迁移可运行 npx tsdown-migrate。配置通过 defineConfig 导出对象或数组,也可使用函数做条件配置;workspace 字段可用 glob 构建多包。CLI 支持 --format、--outDir、--minify、--dts、--sourcemap、--clean 等选项,入口可传单个文件、glob 或多个文件。
适用场景:基础库打包、多入口库、浏览器 IIFE/UMD 库、React 组件库、保留目录结构的工具库、CI 感知配置、WASM 模块与带钩子的高级构建。
限制:CSS 处理标注为实验性、仍在开发中;部分能力依赖插件或额外配置;具体平台支持、性能数据与收费信息暂未提供。