如何在Turborepo中将内部库内联到外部库构建产物中？

问题描述 #

我正在遵循Turborepo官方指南操作，但Turborepo构建外部包时，未将依赖的内部库（如fsm、adapters）打包进产物，而是保留在node_modules中，导致包无法正常发布到npm。

我的外部包package.json配置如下：

{
  "name": "myExternalPackage",
  "main": "./dist/index.js",
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
  "dependencies": {
    "fsm": "workspace:*",
    "adapters": "workspace:*"
  },
  "scripts": {
    "build": "tsup src/index.ts --format cjs,esm --dts"
  },
  "devDependencies": {
    "tsup": "^8.0.1"
  }
}

尽管构建后的index.js引用了fsm和adapters，但它们未被包含在产物中。同时想了解：Turborepo是否不侧重npm包发布构建？是否有其他monorepo方案或更完善的Turborepo文档？

解决方案 #

1. 修改tsup配置，强制打包内部依赖 #

tsup默认不会打包dependencies字段里的包，而你的内部库被放在dependencies中，所以需要显式指定将这些内部包打包进产物。有两种实现方式：

• 直接修改package.json中的build命令，添加--no-external参数：

  "scripts": {
    "build": "tsup src/index.ts --format cjs,esm --dts --no-external fsm,adapters"
  }
  

  --no-external会标记指定的包为非外部依赖，从而将它们的代码打包进最终产物。
• 创建tsup.config.ts配置文件，实现更灵活的配置：

  import { defineConfig } from 'tsup';
  
  export default defineConfig({
    entry: ['src/index.ts'],
    format: ['cjs', 'esm'],
    dts: true,
    noExternal: ['fsm', 'adapters'],
  });
  

2. 调整内部包的依赖声明（可选） #

如果fsm、adapters这类内部库仅作为外部包的编译依赖，不需要在运行时被外部包的消费者安装，可以将它们从外部包的dependencies移到devDependencies，同时配合上述tsup的noExternal配置，确保代码被打包进产物。这种方式适合内部库完全嵌入外部包的场景。

相关疑问解答 #

• Turborepo本身支持npm包发布，它的核心优势在于monorepo的任务编排、缓存加速，默认不会干涉各个子包的构建工具逻辑（比如tsup、rollup的打包规则）。你遇到的问题本质是tsup的默认配置导致的，和Turborepo的发布能力无关。
• 其他可选的monorepo方案：
  • Nx：对包构建、发布有更精细化的内置支持，适合复杂的多包协作场景。
  • Lerna：专门针对npm包发布的monorepo工具，内置版本管理、批量发布流程，适合以包发布为核心的项目。
• Turborepo官方文档覆盖了基础的包发布场景，若需要进阶配置，可以参考其GitHub仓库的社区讨论、示例项目，那里有不少用户分享的复杂场景解决方案。

内容的提问来源于stack exchange，提问作者Igor Loskutov