在Monorepo中使用NPM Workspaces共享依赖版本

1. 根package.json配置核心规则 #

在Monorepo根目录的package.json中完成以下配置，确保版本统一和强制锁定：

• 明确子包路径：通过workspaces字段指定所有WEB应用、子包的位置（如apps/*、packages/*）
• 声明统一版本：在devDependencies（或dependencies，根据依赖类型）中固定Next.js版本为14.0.3
• 强制版本锁定：添加overrides字段，确保所有子包无论是否指定其他版本，最终都会使用14.0.3

示例根package.json：

{
  "name": "my-monorepo",
  "private": true,
  "workspaces": [
    "apps/web-app-1",
    "apps/web-app-2",
    "packages/*"
  ],
  "devDependencies": {
    "next": "14.0.3"
  },
  "overrides": {
    "next": "14.0.3"
  }
}

2. 清理子包的冗余版本配置 #

检查所有WEB应用子包的package.json，做如下处理：

• 若子包之前单独指定了Next.js版本，可直接删除该依赖项（会自动继承根目录的版本）
• 也可保留依赖项但不写版本号，写成"next": "*"
• 若要显式声明依赖关系，可写成"next": "^14.0.3"，但overrides会确保实际安装的是固定版本

示例子包package.json：

{
  "name": "web-app-1",
  "devDependencies": {
    "next": "*"
  }
}

3. 安装依赖并验证版本 #

在Monorepo根目录执行安装命令：

npm install

安装完成后，可在任意子包目录运行以下命令验证版本：

npm list next

输出应显示next@14.0.3，且依赖来源为根目录的node_modules。

补充说明 #

• overrides是强制统一的关键：即使子包依赖树中引入了其他版本的Next.js，NPM会自动替换为指定的14.0.3
• 根目录package.json需设置private: true，避免Monorepo根被意外发布
• 如需统一多个依赖版本，只需在overrides中添加对应条目即可，例如：

"overrides": {
  "next": "14.0.3",
  "react": "18.2.0",
  "react-dom": "18.2.0"
}

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