如何使用Turbopack构建并打包单个软件包

先理清楚现状 #

Turbopack目前的核心优化完全围绕Next.js开发场景，官方压根没怎么给非Next.js的Node.js包做构建支持文档，这就是为啥Turborepo示例里非Next.js项目全用tsup或者esbuild——这俩工具针对单包构建的配置更成熟、上手更快。

硬要用Turbopack构建单包的可行方案 #

1. 写基础配置文件 #

在你的TS包根目录建一个turbopack.config.ts（用js也行），指定Node.js目标环境：

import { defineConfig } from '@turbo/pack';

export default defineConfig({
  target: 'node18', // 对应你Firebase用的Node版本
  entry: './src/index.ts',
  output: {
    filename: 'index.js',
    path: './dist',
    format: 'cjs', // Firebase Node.js环境一般用CommonJS
  },
  resolve: {
    extensions: ['.ts', '.js'],
  },
  module: {
    rules: [
      {
        test: /\.ts$/,
        use: 'ts-loader', // 靠ts-loader处理TypeScript
      },
    ],
  },
});

2. 加构建脚本 #

在包的package.json里加个脚本：

{
  "scripts": {
    "build": "turbo pack build"
  },
  "devDependencies": {
    "@turbo/pack": "^1.10.12",
    "ts-loader": "^9.5.1",
    "typescript": "^5.3.3"
  }
}

3. 踩坑提醒 #

• Turbopack对Node.js包的tree-shaking、外部依赖处理（比如firebase-admin这种不用打包的依赖）远不如tsup/esbuild成熟，得手动在配置里加externals：

  export default defineConfig({
    // ...其他配置
    externals: ['firebase-admin', 'firebase-functions'],
  });
  

• 如果你的包依赖链复杂或者有自定义构建逻辑，现阶段用tsup/esbuild的适配成本低太多。Turbopack现在更像Next.js专属的构建工具，还没完全做到Webpack那种通用打包器的程度。

总结 #

虽然官方说Turbopack是Webpack的继任者，但它的迭代路线是先啃Next.js生态，再慢慢扩展到其他场景。现在用Turbopack构建单Node.js包能跑，但配置麻烦、稳定性不如tsup/esbuild，要是想快速落地，继续用tsup/esbuild配合Turborepo才是务实的选择。

内容的提问来源于stack exchange，提问作者Thijs Koerselman