安装React Native CLI后运行npm start持续出现ENOENT错误求助

问题描述 #

我被这个问题困扰5天了，试过完全卸载后重新从头搭建项目，但问题依然存在。每次执行npm start都会抛出以下错误：

ProjectName@0.0.1 start
node node_modules/react-native/local-cli/cli.js start

npm ERR! code ENOENT
npm ERR! syscall spawn bash
npm ERR! path C:\Users\M Khalil\Desktop\ReactNative\myapp\ProjectName
npm ERR! errno -4058
npm ERR! enoent spawn bash ENOENT
npm ERR! enoent This is related to npm not being able to find a file.
npm ERR! enoent

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\M Khalil\AppData\Local\npm-cache\_logs\2023-02-01T08_45_52_276Z-debug-0.log

项目进度已经严重滞后，急需解决办法。我搜过相关资料、反复重装依赖和项目，都没效果。

解决办法 #

1. 配置Git Bash环境变量 #

Windows系统下出现这个错误，核心原因是npm找不到bash执行环境。解决步骤：

• 安装Git（自带Git Bash），安装时务必勾选「Add Git to PATH」选项
• 若已安装Git，手动将C:\Program Files\Git\bin和C:\Program Files\Git\usr\bin路径添加到系统环境变量的Path中
• 重启终端后，再次执行npm start

2. 修改package.json的start命令 #

避开bash依赖，改用React Native官方推荐的命令：
打开项目根目录的package.json，将原有start命令：

"start": "node node_modules/react-native/local-cli/cli.js start"

替换为：

"start": "npx react-native start"

3. 匹配Node.js与npm版本兼容性 #

React Native对Node.js版本有严格要求，不匹配也会导致异常：

• 查看项目依赖的React Native版本对应的Node.js要求（可查项目README或官方文档）
• 用nvm切换到兼容版本，重装依赖：

nvm install <目标版本号>
nvm use <目标版本号>
npm install

4. 清理缓存重装依赖 #

执行以下命令清理残留缓存并重新安装：

npm cache clean --force
# Windows系统执行下面两行
rd /s /q node_modules
del package-lock.json
# macOS/Linux系统执行下面两行
# rm -rf node_modules package-lock.json
npm install

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