常见问题解答

为什么 tsdown 不支持 Stub 模式

由于多方面的限制和设计考量，tsdown 不支持 stub 模式：

• Stub 模式需要手动干预： 每当您更改命名导出时，都必须重新运行 stub 命令以更新 stub 文件。这会打断开发流程，并可能导致不一致。
• Stub 模式与插件不兼容： Stub 模式无法支持插件功能，而插件对于许多高级用例和自定义构建逻辑来说是必不可少的。

推荐替代方案

与 stub 模式相比，我们推荐更可靠、更灵活的方式：

1. 使用监听模式（Watch Mode）： 最简单的方案是运行 tsdown 的监听模式。这样，您每次修改代码时，构建会自动保持最新，虽然需要让进程在后台持续运行。

2. 使用 exports.devExports 实现开发/生产环境分离： 更高级且健壮的方案是使用 exports.devExports 选项，为开发和生产环境指定不同的导出路径。这样可以在开发时指向源码文件，生产时指向构建产物。

   • 如果您使用插件： 推荐使用 vite-node 直接运行代码，并支持插件。
   • 如果您不使用插件： 可以使用轻量级 TypeScript 运行器，如 tsx、jiti 或 unrun。
   • 如果您不使用插件且代码兼容 Node.js 原生 TypeScript 支持： 在 Node.js v22.18.0 及以上版本，您可以直接运行 TypeScript 文件，无需额外运行器。

这些替代方案相比 stub 模式，能为您的项目带来更流畅、更可靠的开发体验，尤其是在项目规模扩大或需要插件支持时。关于这一决策的详细说明，请参阅 这条 GitHub 评论。