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

新电脑上React应用无法启动,遇MODULE_NOT_FOUND错误求解决

解决React应用启动时找不到react-scripts模块的问题

以下是针对新电脑环境的排查和解决步骤:

  • 检查Node.js版本兼容性
    不同版本的react-scripts对Node.js版本有要求,先查看项目package.json中的engines字段(如果有),确认本地Node.js版本是否符合要求。运行命令查看当前版本:

    node -v
    

    如果版本不匹配,建议用版本管理工具(如nvm、n)切换到对应版本后重新安装依赖。

  • 清理npm缓存并重装依赖
    缓存损坏可能导致依赖安装不完整,执行以下命令:

    npm cache clean --force
    # Windows系统执行:del /s /q node_modules && del package-lock.json
    rm -rf node_modules package-lock.json
    npm install
    
  • 卸载全局react-scripts并使用本地调用
    全局安装的react-scripts可能与项目本地版本冲突,先卸载全局版本:

    npm uninstall -g react-scripts
    

    之后用npx直接调用本地依赖启动项目,避免路径解析问题:

    npx react-scripts start
    
  • 检查项目路径与权限
    Windows环境下,如果项目路径包含中文、空格或特殊字符,可能导致模块解析失败,将项目移动到路径简洁的目录(如C:\dev\my-react-app)。同时尝试以管理员身份打开命令提示符,重新执行依赖安装和启动命令,避免权限不足导致的文件写入问题。

  • 检查package.json脚本配置
    确认package.json中的scripts字段是否正确,比如start脚本应为:

    "scripts": {
      "start": "react-scripts start",
      "build": "react-scripts build",
      "test": "react-scripts test",
      "eject": "react-scripts eject"
    }
    

    避免拼写错误或自定义脚本路径错误。

  • 尝试使用Yarn替代npm
    若以上步骤无效,换用Yarn安装依赖可能解决npm的兼容性问题:

    npm install -g yarn
    rm -rf node_modules package-lock.json
    yarn install
    yarn start
    

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.21 19:52:41