本地安装Node.js包时为何附带node_modules？如何规避？

我完全懂你的困扰——本地安装自己开发的firstmodule时，它的node_modules居然被一并复制到主项目里，导致应用体积骤增，这和从npm仓库下载的包表现完全不一样。别着急，这是本地路径安装的默认行为，咱们可以通过几个实用方法解决：

方法1：用yarn link替代直接路径安装 #

这是本地开发调试最便捷的方式，根本不会复制依赖目录：

• 先在你的firstmodule目录下执行：

  yarn link
  

• 切换到主应用目录，再执行：

  yarn link firstmodule
  

Yarn会创建符号链接，让主应用共享自身的node_modules来满足firstmodule的依赖需求，完全不会额外复制任何依赖文件。

方法2：配置package.json的files字段排除node_modules #

如果必须用路径安装（比如要测试打包后的完整效果），可以在firstmodule的package.json里添加files字段，明确指定安装时要包含的文件：

{
  // 保留你原有配置
  "files": [
    "dist/**/*",
    "package.json",
    "README.md" // 可选，如果你有说明文档的话
  ]
}

这个字段会告诉Yarn（或npm）：安装该包时，只复制指定的文件/目录，自动忽略node_modules、.git这类未被指定的内容。

方法3：生成.tgz压缩包再安装 #

这种方式和从npm仓库下载包的行为完全一致：

• 在firstmodule目录下运行：

  yarn pack
  

  这会生成一个类似firstmodule-1.0.0.tgz的压缩包。
• 到主应用目录安装这个压缩包：

  yarn add /path/to/firstmodule-1.0.0.tgz
  

压缩包里只会包含你指定的文件（没配置files的话，也会自动忽略node_modules、.git等常规忽略项），安装时包的依赖会被Yarn自动扁平化到主项目的node_modules中，不会重复嵌套。

补充：为什么从npm下载的包不会带node_modules？ #

因为npm仓库里的包都是经过发布流程处理的——发布时npm会自动排除node_modules（除非你特意在files里包含，但没人会这么做），而且安装时包的依赖会被包管理器（npm/Yarn）统一处理，扁平化到主项目的node_modules里，避免重复安装和嵌套。

结合你的配置来看，你的firstmodule的package.json缺少files字段，所以Yarn在路径安装时会复制整个目录，包括node_modules。加上这个字段就能直接解决问题啦。

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