如何在多个 Node.js 项目间共享 node_modules 目录-js教程-PHP中文网

如何在多个 Node.js 项目间共享 node_modules 目录

通过 npm workspaces 实现跨项目依赖复用，避免重复安装相同模块，节省磁盘空间并统一管理依赖版本。

通过 npm workspaces 实现跨项目依赖复用，避免重复安装相同模块，节省磁盘空间并统一管理依赖版本。

在开发多个小型 Node.js 教程项目时，为每个项目单独安装 Express、lodash 等常用依赖不仅浪费存储空间，还增加了版本不一致和维护成本。直接修改 require() 路径（如 require("../shared_directory/express")）无法生效，因为 Node.js 的模块解析机制不会从任意路径加载已安装的第三方模块——它只在当前项目的 node_modules 或其祖先目录中按规则查找，且要求模块必须符合 CommonJS 或 ESM 的包结构规范（含 main 字段或 exports 配置）。

✅ 正确方案：使用 npm workspaces（自 npm v7.0+ 原生支持）

npm workspaces 允许你在单一根目录下管理多个子项目（packages），所有子项目共享顶层 node_modules，同时支持独立依赖与全局依赖混合管理。

✅ 推荐目录结构

my-workspace/
├── package.json          # 根级 workspace 配置
├── package-lock.json
├── node_modules/         # 所有子项目共用的依赖安装位置
├── project_1/
│   ├── app.js
│   └── package.json      # { "name": "project-1", "dependencies": { "express": "^4.18.0" } }
├── project_2/
│   ├── app.js
│   └── package.json      # { "name": "project-2", "dependencies": { "lodash": "^4.17.0" } }

? 初始化步骤

创建根 package.json 并启用 workspaces

// my-workspace/package.json
{
"name": "my-workspace",
"private": true,
"workspaces": ["project_1", "project_2"]
}

为每个子项目添加 package.json（含唯一 name 字段）

Revealjs Presentations
创建、编辑并部署 reveal.js 演示文稿为单个 HTML 文件，可选自定义 CSS。适用于需要制作演示文稿、幻灯片或宣传材料时使用。

下载
```
// project_1/package.json
{
"name": "project-1",
"version": "1.0.0",
"type": "commonjs",
"dependencies": {
 "express": "^4.18.2",
 "body-parser": "^1.20.2"
}
}
```
在根目录执行安装
```
cd my-workspace
npm install
```
→ npm 将自动解析所有子项目的 dependencies，统一安装到根目录 node_modules/ 中。

子项目中正常 require（无需相对路径！）

// project_1/app.js
const express = require('express');        // ✅ 自动从根 node_modules 解析
const bodyParser = require('body-parser'); // ✅ 同上

⚠️ 注意事项

所有子项目 package.json 必须包含 "name" 字段（值需唯一且合法，不能为 . 或空字符串）；
不要手动修改 node_modules 内容或使用符号链接模拟共享——这会破坏 npm 的依赖图谱与 hoisting 逻辑；
若需某模块仅被特定项目使用，仍应在对应子项目 package.json 中声明；若需全局共享（如 ESLint、Jest），可声明在根 devDependencies 中；
使用 npm run build 等脚本时，建议在子项目中定义 scripts，并通过 npm run build --workspace=project-1 调用。