Windows11下expo init创建RN项目提示模板提取错误怎么办

基础环境信息 #

• 操作系统：Windows 11
• 依赖版本：Node 16.15.1、NPM 8.12.2
• 触发操作：执行expo init awesomeProject初始化空项目时流程中断

报错日志 #

Error downloading and extracting template package: Error: npm exited with non-zero code: 1
× Something went wrong while downloading and extracting the template.

Can't read JSON file: D:\crna\awesomeProject\app.json
└─ Cause: Error: ENOENT: no such file or directory, open 'D:\crna\awesomeProject\app.json'

报错根因：模板包下载解压阶段npm异常退出，项目基础文件未生成，后续读取app.json配置时直接触发文件不存在错误。

修复步骤 #

按优先级依次操作，每步完成后重新执行初始化命令测试：

• 清理npm损坏缓存
  管理员身份打开终端，执行命令清除本地缓存：
  npm cache clean --force
• 修正npm源配置
  非公网镜像源经常出现模板包版本索引不全、压缩包下载损坏的问题，初始化阶段先切到npm官方源：
  npm config set registry https://registry.npmjs.org/
  项目初始化完成后，可根据需要切换回国内源安装业务依赖。
• 检查路径合法性
  确保执行初始化命令的工作目录全路径不含中文、空格、特殊符号，不要放在带中文用户名的桌面、文档目录下，当前使用的D:\crna路径符合要求，可直接使用。
• 重装全局expo-cli工具
  旧版本expo-cli和Node 16.x存在兼容问题，先卸载旧版本再安装最新稳定版：

npm uninstall -g expo-cli
npm install -g expo-cli@latest

• 绕过全局包兼容问题
  如果全局重装后依旧报错，直接使用npx拉取最新版create-expo-app初始化，跳过全局expo-cli的版本兼容问题：
  npx create-expo-app awesomeProject

注意：Windows系统下执行终端操作时尽量使用管理员权限打开命令行/PowerShell，权限不足会导致npm写文件失败，触发同类ENOENT报错。

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