Turbo Repo+pnpm环境下React 17项目误取React 18类型求助

以下是针对Turbo Repo + pnpm单仓中React版本类型冲突的有效解决办法：

• 给React 17项目明确锁定类型版本
  在React 17项目的package.json的devDependencies中，直接指定与React 17匹配的@types/react和@types/react-dom版本，比如：

  "devDependencies": {
    "@types/react": "^17.0.60",
    "@types/react-dom": "^17.0.20"
  }
  

  执行pnpm install后，pnpm会为该子项目单独安装对应类型包，避免共享根目录的React 18类型。

• 配置pnpm选择性不提升React相关包
  在项目根目录的.npmrc中添加以下配置，阻止pnpm将React及其类型包提升到根node_modules：

  # 禁止提升React类型包
  public-hoist-pattern[]=!@types/react
  public-hoist-pattern[]=!@types/react-dom
  # 可选：如果React本体也有冲突，一并禁止提升
  public-hoist-pattern[]=!react
  public-hoist-pattern[]=!react-dom
  

  之后删除所有node_modules和锁文件，重新执行pnpm install。

• 调整TS配置强制使用子项目类型
  在React 17项目的tsconfig.json中，明确指定类型查找的根目录，让TypeScript优先使用当前项目的node_modules：

  {
    "compilerOptions": {
      "typesRoot": "./node_modules/@types",
      "types": ["react", "react-dom"]
    }
  }
  

  同时可以在Turbo Repo的turbo.json中，为React 17项目单独设置环境变量，确保构建时的路径隔离：

  {
    "pipeline": {
      "your-react17-app:build": {
        "env": {
          "NODE_PATH": "./node_modules"
        }
      }
    }
  }
  

  替换your-react17-app为你实际的项目名称。

• 使用pnpm workspace overrides强制版本隔离
  在根目录的package.json中添加pnpm.overrides配置，为React 17项目强制指定类型版本：

  "pnpm": {
    "overrides": {
      "@types/react": {
        "your-react17-app": "^17.0.60"
      },
      "@types/react-dom": {
        "your-react17-app": "^17.0.20"
      }
    }
  }
  

  这个配置会强制pnpm为指定子项目安装对应版本的依赖，不受全局hoist的影响。

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