You need to enable JavaScript to run this app. Windows环境下执行npx create-react-app创建项目报spawn UNKNOWN错误
优惠活动
大模型
产品
解决方案
定价
更多

Windows环境下执行npx create-react-app创建项目报spawn UNKNOWN错误

Windows 10 20H2环境下create-react-app报spawn UNKNOWN错误的解决方案

问题基本特征

  • 适用环境:Windows 10 20H2操作系统、Node.js v14.15.4版本
  • 触发操作:在D盘根目录执行npx create-react-app abc命令创建React项目
  • 流程表现:npx完成67个临时依赖的拉取安装后,在执行react、react-dom、react-scripts、cra-template核心依赖安装步骤时异常中断,抛出通用UNKNOWN类型错误,errno值为-4094;流程终止后会自动清理临时生成的package.json文件、D盘下的abc项目目录
  • 报错定位:异常触发点为cross-spawn组件拉起子进程的逻辑,位于npx缓存路径下的create-react-app源码中,系统未返回细分的权限、路径类错误提示,仅返回spawn UNKNOWN通用标识
  • 问题跟进状态:已同步提交至create-react-app官方GitHub仓库记录

可直接落地的解决操作

  • 替换执行逻辑,跳过npx临时拉取流程
    全局安装兼容版本的create-react-app,执行命令:
    npm install -g create-react-app@5.0.0
    
    安装完成后直接调用全局命令创建项目,避开npx缓存目录下cross-spawn组件的进程调用权限异常。
  • 调整终端运行权限
    右键选择「以管理员身份运行」打开系统终端,切换到D盘目标目录后再执行项目创建命令。Windows 10 20H2版本对非管理员进程的子进程生成、磁盘根目录写入操作存在拦截规则,无明确弹窗提示时仅会返回spawn UNKNOWN通用错误。
  • 修正npm脚本执行shell配置
    先执行命令查看当前npm配置的脚本shell路径:
    npm config get script-shell
    
    若返回值为空或指向无效路径,手动绑定系统自带的cmd执行路径:
    npm config set script-shell "C:\\Windows\\System32\\cmd.exe"
    
    Node.js v14.15.4在Windows环境下不会自动绑定系统shell路径,配置缺失会直接导致cross-spawn无法拉起npm安装子进程,触发UNKNOWN报错。
  • 清理异常npx缓存
    若上述操作后依然报错,手动删除npx生成的异常缓存目录C:\Users\Gilang\AppData\Roaming\npm-cache\_npx\17768,重新执行创建命令即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 15:45:02