You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native构建失败求助:无法找到指定CLI模块

React Native run-android 构建失败解决指南

核心问题分析

你的错误本质是路径编码乱码(非ASCII字符Masaüstü被解析为Masaüstü)导致找不到CLI模块,同时可能存在依赖缓存或CLI损坏问题。


分步解决方法

1. 迁移项目到纯英文路径

Windows系统对含非英文字符的路径支持不佳,直接把项目从C:\Users\azcak\OneDrive\Masaüstü\AwesomeProject移动到无特殊字符的路径,比如:
C:\Users\azcak\Projects\AwesomeProject

2. 重置依赖与缓存

删除旧依赖和锁定文件,重新安装:

rm -rf node_modules
del package-lock.json yarn.lock  # Windows用del,Mac/Linux用rm
npm cache clean --force
npm install

3. 修复React Native CLI

如果本地CLI模块损坏,全局安装最新版CLI:

npm install -g @react-native-community/cli

或者直接指定CLI版本运行构建:

npx @react-native-community/cli@latest run-android

4. 清理Android构建缓存

进入Android目录清理构建残留:

cd android
gradlew clean  # Windows用这个,Mac/Linux用./gradlew clean
cd ..

清理完成后重新执行:

npx react-native run-android

5. 确认Node.js版本兼容性

React Native 0.70+兼容Node.js 16-20 LTS,你当前的v18.16.0没问题,但如果问题仍存在,可以切换到更稳定的LTS版本(比如18.17.0),用nvm管理更方便:

nvm install 18.17.0
nvm use 18.17.0

内容的提问来源于stack exchange,提问作者Aquex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.22 02:49:58