tsup默认只输出CJS格式（dist/index.js）且不生成.d.ts，因设计上优先最小可行输出；需显式配置format:["cjs","esm"]和dts:true才能多格式+类型声明。

tsup 能直接替代 tsc + rollup 构建库，但「多格式一键输出」不是开箱即用——必须显式指定 --format，否则只出 CJS。

为什么 npm run build 只生成 .js 却没有 .mjs 和 .d.ts

默认行为是只输出 CommonJS 格式（dist/index.js），不带类型声明、不生成 ESM。这不是 bug，是设计取舍：tsup 优先保证最小可行输出，避免隐式行为导致发布污染。

• --format cjs,esm 必须写全，缺一不可；只写 --format esm 会丢掉 CJS 兼容层
• --dts 是独立开关，不加就不会生成 dist/index.d.ts，哪怕你源码里写了 export * 或 declare module
• 若入口是 src/index.ts，但 package.json 的 "main" 指向 "dist/index.js"，而 "exports" 缺失，则 Node.js 14+ 无法自动选中 ESM 入口——得手动补 "exports": { ".": { "import": "./dist/index.mjs", "require": "./dist/index.js" } }

tsup.config.ts 里哪些配置项最常改

零配置只适用于极简场景。真实项目几乎立刻要动这三项：

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

• entry：默认只认 src/index.ts，多个入口（如 CLI + library）必须显式列出数组：["src/index.ts", "src/cli.ts"]
• format：不能依赖命令行传参，CI 环境容易漏；写死在 config 里更稳：format: ["cjs", "esm"]
• dts：设为 true 启用类型生成；若需排除某些路径（如测试类型），得配 dts: { only: ["src/index.ts"] }

注意：minify: true 在生产构建时才开，开发阶段关掉——否则报错堆栈无法映射回源码。

VSCode 调试时断点失效，和 tsup 有什么关系

tsup 默认不生成 .map 文件，且输出的是纯 JS（非 TS 编译产物），所以 VSCode 的 Node.js 调试器找不到源映射。这不是配置错误，是默认关闭调试支持。

• 加 --sourcemap 参数（命令行）或 sourcemap: true（config）才能生成 .js.map
• launch.json 中的 outFiles 必须匹配输出路径，例如："${workspaceFolder}/dist/**/*.js"，不能写成 build 或 lib
• 别指望 program 直接指向 .ts 文件——tsup 不处理 TS 源码调试，它只打包；要边写边调，该用 ts-node --inspect 配合 nodemon

真正麻烦的不是配置项多，而是每个输出格式（CJS/ESM）和类型声明（.d.ts）各自有独立的启用开关，且它们之间不联动。漏一个，下游用户就可能遇到 Cannot find module 或 has no exported member —— 这些错误不会在本地构建时报出来，只会在别人 import 你的包时爆发。