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

使用create-react-app创建React项目失败,提示未知奇怪错误

create-react-app 创建项目报错通用解决方案
  • 先卸载全局安装的旧版 create-react-app,避免版本冲突:
    # npm 卸载
    npm uninstall -g create-react-app
    # yarn 卸载
    yarn global remove create-react-app
    
    卸载完成后直接使用npx调用最新版本创建项目:
    npx create-react-app@latest 你的项目名称
  • 检查npm镜像源配置,旧版淘宝镜像源已停止服务,会导致依赖拉取失败,可以切换到官方源或新版淘宝源:
    # 切换官方源
    npm config set registry https://registry.npmjs.org/
    # 切换新版淘宝源
    npm config set registry https://registry.npmmirror.com/
    
  • 确认创建项目的本地路径没有中文、空格、特殊字符(如emoji、括号等),路径存在特殊字符会导致部分依赖编译、安装失败。
  • 排查权限问题:Windows系统使用管理员权限打开终端执行命令;Mac/Linux系统执行命令前添加sudo提权,或修改npm全局目录权限避免权限拦截。
  • 尝试使用其他包管理器创建项目,排除npm本身的故障:
    # 使用yarn创建
    yarn create react-app 你的项目名称
    # 使用pnpm创建
    pnpm create react-app 你的项目名称
    
  • 确认当前使用的Node版本为官方LTS版本(16.x、18.x、20.x均可),非稳定版或过旧的Node版本都会存在兼容性问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.07 06:27:00