执行npx create-react-app时遇spawn UNKNOWN错误，寻求解决办法

问题场景 #

已安装Node.js v16.18.0和npm 8.19.2，在PowerShell中执行npx create-react-app my-app创建React项目时，出现如下错误：

PS C:\Users\Owner> npx create-react-app my-app

Creating a new React app in C:\Users\Owner\my-app.

Installing packages. This might take a couple of minutes.
Installing react, react-dom, and react-scripts with cra-template...


Aborting installation.
Unexpected error. Please report it as a bug:
Error: spawn UNKNOWN
    at ChildProcess.spawn (node:internal/child_process:420:11)
    at Object.spawn (node:child_process:733:9)
    at spawn (C:\Users\Owner\AppData\Local\npm-cache\_npx\c67e74de0542c87c\node_modules\cross-spawn\index.js:12:24)
    at C:\Users\Owner\AppData\Local\npm-cache\_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:383:19
    at new Promise (<anonymous>)
    at install (C:\Users\Owner\AppData\Local\npm-cache\_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:334:10)
    at C:\Users\Owner\AppData\Local\npm-cache\_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:461:16
    at processTicksAndRejections (node:internal/process/task_queues:96:5) {
  errno: -4094,
  code: 'UNKNOWN',
  syscall: 'spawn'
}

Deleting generated file... package.json
Deleting my-app/ from C:\Users\Owner
Done.
PS C:\Users\Owner>

解决方案 #

• 检查PowerShell执行策略
  以管理员身份启动PowerShell，执行Get-ExecutionPolicy查看当前策略。如果显示Restricted，执行Set-ExecutionPolicy RemoteSigned，输入Y确认修改。执行策略过严会限制进程创建，导致spawn失败。

• 清除npm缓存后重试
  执行npm cache clean --force清空缓存，之后重新运行npx create-react-app my-app。缓存损坏可能导致依赖安装时进程调用异常。

• 临时禁用杀毒软件/防火墙
  部分杀毒软件或Windows Defender会拦截Node.js的子进程创建操作，临时关闭相关防护工具后再尝试创建项目，验证是否是防护软件导致的问题。

• 切换终端环境
  放弃使用PowerShell，改用CMD或Git Bash执行npx create-react-app my-app命令。不同终端的环境变量和权限配置可能存在差异，换终端能规避PowerShell特有的问题。

• 全局安装create-react-app后创建项目
  先执行npm install -g create-react-app全局安装工具，再运行create-react-app my-app创建项目。全局安装的工具可能绕过npx临时缓存的异常问题。

• 检查Node.js环境变量
  确认系统环境变量的Path中包含Node.js的安装路径（通常是C:\Program Files\nodejs\）。如果没有添加，手动添加后重启终端再试。环境变量缺失会导致进程调用时无法找到依赖程序。

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