通过 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 字段）
// 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 调用。
? 进阶提示
- 支持 npm install <pkg> --workspace=project-1 为指定项目添加依赖；
- 可结合 pnpm（更严格的符号链接隔离）或 yarn workspaces，但 npm workspaces 已足够轻量可靠；
- 对纯学习型小项目，还可考虑 npm link（适合单模块复用），但 workspaces 更适合多项目协同场景。
通过 npm workspaces，你不再需要“复制粘贴” node_modules，也不必硬编码路径——让工具链为你智能管理依赖拓扑，专注代码本身。
