PNPM monorepo中@react-native-community/cli依赖未链接至node_modules问题

1. 升级PNPM到最新稳定版 #

旧版本PNPM的hoisting逻辑可能存在bug，先升级到最新版规避已知问题：

pnpm add -g pnpm@latest

2. 清理缓存并重新安装 #

缓存或损坏的lock文件可能导致依赖安装异常，执行以下步骤重置：

• 清除PNPM全局缓存：pnpm store prune
• 删除项目内的node_modules和pnpm-lock.yaml文件
• 重新执行安装：pnpm install

3. 细化Hoisting配置 #

仅设置shamefully-hoist=true可能不足以覆盖RN CLI的所有依赖，在项目根目录的.npmrc中添加强制提升规则，确保相关依赖被放到顶层node_modules：

shamefully-hoist=true
# 强制提升RN CLI相关子包
hoist-pattern[]=@react-native-community/*
# 强制提升CLI依赖的第三方包
hoist-pattern[]=chalk
hoist-pattern[]=commander
hoist-pattern[]=execa
hoist-pattern[]=find-up
hoist-pattern[]=fs-extra
hoist-pattern[]=graceful-fs
hoist-pattern[]=prompts
hoist-pattern[]=semver

4. 确认Monorepo结构配置 #

检查根目录的pnpm-workspace.yaml，确保React Native项目所在目录被正确纳入monorepo范围：

packages:
  - 'packages/*' # 根据你的实际目录调整，比如apps/*

同时确认RN项目的package.json中已正确声明@react-native-community/cli为依赖（建议放在devDependencies）。

5. 验证版本兼容性 #

@react-native-community/cli@11.2.0对应React Native 0.7x系列版本，确保你的RN项目版本与CLI版本匹配，版本不兼容可能导致依赖安装失败。

临时解决方案：手动链接依赖 #

如果以上方法都无效，可手动将依赖安装到根目录并链接到RN项目：

1. 在根目录安装所有缺失依赖：

pnpm add -D @react-native-community/cli-clean@11.2.0 @react-native-community/cli-config@11.2.0 @react-native-community/cli-debugger-ui@11.2.0 @react-native-community/cli-doctor@11.2.0 @react-native-community/cli-hermes@11.2.0 @react-native-community/cli-plugin-metro@11.2.0 @react-native-community/cli-server-api@11.2.0 @react-native-community/cli-tools@11.2.0 @react-native-community/cli-types@11.2.0 chalk@^4.1.2 commander@^9.4.1 execa@^5.0.0 find-up@^4.1.0 fs-extra@^8.1.0 graceful-fs@^4.1.3 prompts@^2.4.0 semver@^6.3.0

2. 进入RN项目目录，依次执行链接命令（以cli-clean为例）：

pnpm link @react-native-community/cli-clean

重复此步骤完成所有依赖的链接。

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