如何在pnpm工作区同步依赖包版本且不污染根目录？

1. 用共享依赖包+子工作区分组 #

专门建一个shared-deps包来统一管理apps和components的依赖版本，同时通过工作区配置把这三者归为一组，其他目录排除在外，避免污染。

• 操作步骤：
  • 在根目录新建shared-deps文件夹，里面写package.json，把需要统一版本的依赖都放进去：

    {
      "name": "shared-deps",
      "version": "1.0.0",
      "dependencies": {
        "react": "^18.2.0",
        "react-dom": "^18.2.0"
      },
      "devDependencies": {
        "typescript": "^5.2.2"
      }
    }
    

  • 修改根目录的pnpm-workspace.yaml，只把shared-deps、apps、components纳入工作区，其他目录排除：

    packages:
      - 'shared-deps'
      - 'apps/**'
      - 'components/**'
      - '!other-packages/**'
      - '!docs/**'
    

  • 在apps和components下的每个子项目package.json里，用workspace协议引用shared-deps里的依赖：

    {
      "dependencies": {
        "react": "workspace:^18.2.0",
        "react-dom": "workspace:^18.2.0"
      },
      "devDependencies": {
        "typescript": "workspace:^5.2.2"
      }
    }
    

  • 执行pnpm install后，依赖会装在根目录node_modules，但只有指定分组里的项目能共享，其他目录完全不受影响。

2. 用pnpm overrides+工作区范围限制 #

不想额外建共享包的话，直接在根目录用overrides强制指定版本，同时限制工作区只包含apps和components，其他目录不参与。

• 操作步骤：
  • 修改pnpm-workspace.yaml，仅包含目标目录：

    packages:
      - 'apps/**'
      - 'components/**'
      - '!**'
    

  • 在根目录package.json里加pnpm.overrides字段，锁死依赖版本：

    {
      "pnpm": {
        "overrides": {
          "react": "^18.2.0",
          "react-dom": "^18.2.0",
          "typescript": "^5.2.2"
        }
      }
    }
    

  • 这样只有apps和components下的项目会用这些指定版本的依赖，其他不在工作区的目录完全不受影响，依赖也只会服务于目标项目。

3. 单独建隔离的工作区实例 #

把apps和components移到一个独立的子目录下，单独初始化pnpm工作区，让依赖完全和根仓库其他部分隔离。

• 操作步骤：
  • 调整目录结构，把apps和components放到workspace-core目录下：

    monorepo-root/
      workspace-core/
        apps/
        components/
        pnpm-workspace.yaml
        package.json
      other-packages/
      docs/
    

  • 进入workspace-core目录，执行pnpm init，然后创建pnpm-workspace.yaml：

    packages:
      - 'apps/**'
      - 'components/**'
    

  • 之后在workspace-core里管理依赖，不管是在根package.json统一声明，还是在子项目里单独写，pnpm都会把共享依赖装在workspace-core/node_modules，完全不会影响根目录的其他内容。

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