如何将Git子模块stack的依赖安装到根仓库node_modules目录？

核心配置思路 #

要让stack子模块的依赖安装到项目根目录的node_modules，同时根package.json仅保留对stack的本地依赖，需借助PNPM的专属特性实现依赖的全局共享与自动同步。

步骤1：精简根目录package.json #

确保根目录的package.json只保留stack的本地依赖，结构如下：

{
  "name": "website-one",
  "private": true,
  "dependencies": {
    "stack": "file:stack"
  }
}

步骤2：配置stack的package.json #

在stack/package.json中，将所有项目通用依赖（vue、vite、laravel等）声明在dependencies或devDependencies中，示例：

{
  "name": "stack",
  "version": "1.0.0",
  "dependencies": {
    "vue": "^3.3.4",
    "vite": "^4.4.9",
    "laravel-vite-plugin": "^0.7.8",
    "@inertiajs/vue3": "^1.0.10"
  }
}

步骤3：启用PNPM依赖提升（关键） #

方式A：使用PNPM Workspace（推荐）

1. 在项目根目录创建pnpm-workspace.yaml文件：

packages:
  - "stack"

2. 修改根package.json，将stack的依赖改为workspace协议：

{
  "dependencies": {
    "stack": "workspace:*"
  }
}

3. 执行pnpm install，此时stack的所有依赖会自动安装到根目录node_modules，且PNPM会维护版本一致性。

方式B：使用dependenciesMeta配置（无需workspace）

若不想启用workspace，在根package.json中添加配置强制依赖提升：

{
  "dependencies": {
    "stack": "file:stack"
  },
  "dependenciesMeta": {
    "stack": {
      "injected": true
    }
  }
}

执行pnpm install后，stack的依赖会被安装到根目录node_modules。

步骤4：更新stack后的依赖同步 #

当stack仓库的依赖发生变更（添加/升级/删除）时，在客户项目中执行以下操作：

1. 更新Git子模块：git submodule update --remote stack
2. 执行pnpm install，PNPM会自动检测stack/package.json的变化，同步更新根目录的依赖。

注意事项 #

• 确保stack的package.json中依赖版本明确，避免版本冲突。
• 若出现依赖版本不一致问题，可在根目录package.json中添加pnpm.overrides强制统一版本：

{
  "pnpm": {
    "overrides": {
      "vue": "^3.3.4"
    }
  }
}

• 不要在客户项目根package.json中声明重复依赖，否则会覆盖stack的配置。

内容的提问来源于stack exchange，提问作者Chris at Keddy Digital