如何将common.tgz嵌入model.tgz以避免重复引入依赖？

你遇到的问题本质是：model包打包时没有把依赖的common包一同包含进去，主项目安装model.tgz时，npm会基于主项目的路径去寻找common.tgz，而非model包内部的文件，因此触发ENOENT错误。以下是几种可行的解决方案：

方案一：将common包作为model的内嵌依赖打包 #

这是最直接的解决方式，让model.tgz直接包含common包的内容，无需主项目额外引入：

1. 在model项目根目录，先安装本地的common依赖：

   npm install ./tmp/common.tgz
   

   执行后，model的package.json的dependencies会自动添加类似"common": "file:tmp/common.tgz"的配置。
2. 在model的package.json中添加bundleDependencies字段，指定要内嵌的依赖：

   {
     "name": "model",
     "version": "1.0.0",
     "dependencies": {
       "common": "file:tmp/common.tgz"
     },
     "bundleDependencies": ["common"]
   }
   

   注：bundleDependencies也可以用别名bundledDependencies，效果一致。

3. 重新执行npm pack生成新的model.tgz，此时这个包已经包含了common包的所有内容。
4. 将新的model.tgz放到主项目的tmp目录，执行npm install ./tmp/model.tgz即可正常安装，无需额外处理common.tgz。

方案二：使用私有npm仓库管理依赖（推荐分布式项目） #

如果是团队协作的分布式项目，更规范的方式是搭建私有npm仓库（比如Verdaccio）：

1. 将common包发布到私有仓库：

   npm publish --registry=https://你的私有仓库地址
   

2. 在model项目中，从私有仓库安装common依赖：

   npm install common --registry=https://你的私有仓库地址
   

   此时model的package.json的dependencies会是"common": "^1.0.0"这类标准版本号。
3. 后续无论是打包model.tgz，还是主项目安装model，npm都会自动从私有仓库拉取common依赖，完全避免本地路径问题。

原方法报错原因 #

你之前的model包中，common的依赖路径是相对于model项目的./tmp/common.tgz，当主项目安装model.tgz时，npm会尝试在主项目的tmp目录下寻找common.tgz，而非model包内部的tmp文件夹，因此会触发找不到文件的ENOENT错误。

内容的提问来源于stack exchange，提问作者Giulio Serra