重置电脑后React Native执行gradlew.bat app:installDebug报错求助

核心问题分析 #

从报错信息看，两个关键诱因：

• 项目路径包含非ASCII字符（如Masaüstü），导致系统解析路径时出现乱码（显示为Masaüstü），Node.js无法正确定位模块文件
• @react-native-community/cli模块的build/bin.js文件缺失，说明依赖未正确安装或缓存异常

分步解决方案 #

1. 迁移项目到纯ASCII路径下 #

Windows系统对含非ASCII字符的路径兼容性差，尤其是Node.js、Gradle这类工具：

• 把项目从C:\Masaüstü\gradle\slow移到纯英文路径，比如C:\Projects\RN_Demo
• 确保路径里没有空格、特殊符号或非英文字母

2. 清理并重装依赖 #

模块缺失大概率是依赖安装不完整或缓存污染：

• 删除项目根目录的node_modules文件夹
• 删除package-lock.json（用yarn的话删yarn.lock）
• 执行命令重装依赖：

  npm install
  # 用yarn的话替换成：yarn install
  

3. 清除Gradle缓存 #

Gradle缓存可能残留错误配置：

• 进入项目的android目录，删除.gradle文件夹
• 回到项目根目录，执行清理命令：

  # Windows直接运行
  gradlew.bat clean
  

4. 手动补装缺失的CLI模块 #

如果重装依赖后node_modules/@react-native-community/cli/build/bin.js仍不存在，手动安装：

npm install @react-native-community/cli --save-dev

5. 重新执行构建 #

完成以上步骤后，重新运行构建命令：

npx react-native run-android
# 或者直接用gradle命令：
# gradlew.bat app:installDebug -PreactNativeDevServerPort=8081

额外排查点 #

• 确认Node.js版本与React Native版本兼容（RN 0.70+建议用Node.js 16+，你当前的18.15.0兼容，也可尝试切换到LTS版如18.17.0）
• 检查ANDROID_HOME、JAVA_HOME环境变量是否配置正确，且路径无特殊字符
• 执行npx react-native doctor诊断环境，根据提示修复缺失依赖

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