如何将多级子模块的package.json依赖统一安装到根node_modules？

当然可行！这种在多子模块项目里共享根目录依赖的需求很常见，完全可以实现，下面是具体的操作步骤和注意事项：

核心原理 #

Node.js的模块查找机制是向上遍历目录树：如果当前目录的node_modules找不到目标依赖，就会自动去父目录查找，直到找到项目根目录。所以只要把所有子模块需要的依赖都统一安装在根目录的node_modules里，子模块就能正常加载这些依赖。

具体实现步骤 #

1. 合并所有子模块的依赖到根目录package.json #

你需要把submodule_1和submodule_2的package.json中的dependencies（以及devDependencies，如果开发阶段也需要共享依赖的话）内容合并到根目录的package.json中：

• 手动合并：直接复制子模块里的依赖项到根目录的对应字段即可，注意处理版本冲突——如果同一个依赖在不同子模块里要求不同版本，尽量选择兼容的版本（比如子模块A要lodash@^4.17.0，子模块B要lodash@^4.19.0，可以统一用lodash@^4.19.0）。
• 脚本自动合并（可选）：如果子模块数量较多，可以写个简单的Node脚本自动遍历合并，示例脚本如下：

const fs = require('fs');
const path = require('path');

const rootPackagePath = path.join(__dirname, 'package.json');
const submodules = ['submodule_1', 'submodule_2'];

const rootPackage = JSON.parse(fs.readFileSync(rootPackagePath, 'utf8'));
rootPackage.dependencies = rootPackage.dependencies || {};
rootPackage.devDependencies = rootPackage.devDependencies || {};

submodules.forEach(submodule => {
  const subPackagePath = path.join(__dirname, submodule, 'package.json');
  const subPackage = JSON.parse(fs.readFileSync(subPackagePath, 'utf8'));
  
  // 合并生产依赖
  Object.assign(rootPackage.dependencies, subPackage.dependencies);
  // 合并开发依赖
  Object.assign(rootPackage.devDependencies, subPackage.devDependencies);
});

fs.writeFileSync(rootPackagePath, JSON.stringify(rootPackage, null, 2), 'utf8');

2. 处理版本冲突（关键） #

如果不同子模块对同一个依赖要求的版本不兼容（比如一个要lodash@4.x，另一个要lodash@5.x），可以用npm的overrides字段（npm 8.3.0+支持）强制统一版本：
在根目录的package.json中添加：

"overrides": {
  "lodash": "^5.0.0"
}

这样npm安装时会强制使用你指定的版本，确保所有子模块都能使用统一的依赖版本。

3. 安装根目录依赖 #

在项目根目录运行安装命令：

npm install
# 用yarn的话执行
yarn install

这会把所有合并后的依赖都安装到根目录的node_modules里。

4. 清理子模块的本地依赖 #

确保submodule_1和submodule_2目录下没有自己的node_modules文件夹（如果有的话直接删除），也不要在子模块目录下运行npm install，避免子模块生成独立的依赖目录，干扰Node.js的查找逻辑。

5. 验证依赖是否可用 #

在子模块的代码中尝试引入依赖，比如在submodule_1的某个文件里写：

const lodash = require('lodash');
console.log(lodash.version);

运行该文件，如果能正常输出版本号，说明依赖加载成功。

注意事项 #

• 如果子模块有peerDependencies，需要把这些依赖也安装到根目录的package.json中，因为peer依赖需要宿主环境提供。
• 后续如果子模块新增了依赖，记得同步更新根目录的package.json，然后重新运行安装命令。

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