React Native运行run-android报错：找不到@react-native-community/cli模块

AI 小北

2026-7-21

解决React Native运行npx react-native run-android时@react-native-community/cli模块缺失问题

可行解决方案

全局安装React Native CLI
执行全局安装命令：
```
npm install -g @react-native-community/cli
```
或使用yarn：
```
yarn global add @react-native-community/cli
```
安装完成后，可尝试直接用全局命令启动：
```
react-native run-android
```
补全项目本地CLI依赖
打开项目根目录的package.json，在devDependencies中添加对应版本的CLI依赖（版本号建议与当前React Native版本匹配，如RN 0.7x对应CLI 12.x系列）：
```
"devDependencies": {
  "@react-native-community/cli": "^12.3.0",
  "@react-native-community/cli-platform-android": "^12.3.0"
}
```
保存后执行依赖安装：
```
npm install
```
清理Gradle缓存
1. 进入项目的android子目录
2. 执行清理命令：
  （Linux/macOS）
```
./gradlew clean
```
  （Windows）
```
gradlew.bat clean
```
3. 返回项目根目录重新运行启动命令
校验Node.js版本兼容性
使用node -v查看当前Node.js版本，确保其符合React Native官方要求（如RN 0.7x版本建议Node.js 16.18+），版本不匹配时可通过nvm、n等工具切换到兼容版本。
迁移项目（极端方案）
若以上方法均无效，可创建一个同版本的全新React Native项目，将原有项目的源码、资源文件逐步迁移至新项目，重新安装依赖后尝试启动。