pnpm workspaces中auto-install-peers配置不生效问题咨询

调整现有.npmrc配置 #

先修正冲突项并补充必要配置，最终内容如下：

auto-install-peers=true
save-exact=true
node-linker=hoisted
link-workspace-packages=deep
install-links=true
strict-peer-deps=false

• 移除legacy-peer-deps=true：该配置会禁用npm的peer依赖自动解析逻辑，和auto-install-peers=true完全冲突，是monorepo下peer依赖无法安装的核心原因之一
• 新增install-links=true：确保npm正确处理工作区包之间的链接关系，让子项目能共享根目录的peer依赖
• 新增strict-peer-deps=false：当不同子项目的peer依赖版本存在冲突时，允许npm尝试兼容安装，避免直接终止流程

根目录package.json必须配置工作区 #

在项目根目录的package.json中明确声明所有子项目路径，让npm识别monorepo结构：

{
  "workspaces": [
    "packages/*",
    "apps/*" // 根据你的子项目实际路径调整
  ]
}

正确执行安装操作 #

• 必须在根目录执行npm install，不要单独进入子项目执行安装，这样npm才能统一扫描所有子项目的peer依赖需求，将它们统一安装并提升到根目录的node_modules中
• 若之前安装导致依赖混乱，先清理旧文件再重新安装：

  rm -rf node_modules package-lock.json packages/*/node_modules
  npm install
  

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