使用本地依赖/子导入路径时如何自动安装子依赖？

项目结构与依赖关系 #

• project 依赖 module1
• module1 依赖 lodash
  依赖链：project < module1 < lodash

当前配置情况 #

project 的 package.json 配置 #

"dependencies": {
   "module1": "file:../trunk/module1"
}

module1 的 package.json 配置 #

"dependencies": {
   "lodash": "^4.17.0"
}

问题描述 #

在 project 中执行 npm install，仅会创建 module1 的符号链接，不会自动下载其依赖 lodash；尝试改用子路径导入后，情况完全一致：

子路径导入的 project package.json 配置 #

"imports": {
  "#mod1": {
    "node": "module1",
    "default": "../trunk/module1"
  }
},
"dependencies": {
  "module1": "^1.0.0"
},

导入调用代码 #

import { SampleFunction } from '#mod1'

两种方式下，module1 目录都没有本地的 node_modules，必须手动进入 module1 执行 npm install 才能安装 lodash，现在需要实现无需手动操作，让 npm 自动下载所有子依赖。

解决方案 #

方法1：使用 npm 工作区模式（推荐） #

把两个项目纳入同一个 npm 工作区，就能自动解析所有子依赖：

1. 在 project 和 module1 的共同上级目录创建 package.json，内容如下：

{
  "name": "monorepo-root",
  "private": true,
  "workspaces": [
    "project",
    "../trunk/module1" // 对应你的实际目录结构
  ]
}

2. 进入这个根目录执行 npm install，npm 会自动处理所有工作区的依赖，将 lodash 安装到根目录的 node_modules（或按配置进行依赖提升），确保 module1 和 project 都能正常访问到依赖。

方法2：npm link 结合手动预安装 #

1. 进入 module1 目录，执行 npm install 先安装好自身的 lodash 依赖；
2. 在 module1 目录执行 npm link，将 module1 链接到全局环境；
3. 进入 project 目录执行 npm link module1，此时 project 会使用全局链接的 module1，自然就能访问到 module1 已经安装好的 lodash。

方法3：修改 npm 配置启用本地依赖的子依赖安装 #

通过修改 npm 配置，让它自动安装本地链接依赖的子依赖：

npm config set install-links true

配置完成后，回到 project 目录重新执行 npm install，就能自动下载 module1 的 lodash 依赖了。

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