expo init创建React Native空项目报错app.json不存在如何解决

问题基本信息 #

• 场景：参照官方文档完成React Native开发环境配置后，无法完成空项目创建
• 运行环境：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拉取、解压expo项目模板的进程异常退出（退出码1），模板文件没有完整写入目标目录，导致后续流程读取必须的app.json配置文件时提示文件不存在。常见触发原因包括：

• npm本地缓存损坏，拉取到残缺的模板包
• 网络连接异常，访问npm源、expo模板资源时出现中断、拦截，导致包下载不完整
• 目标目录权限不足，进程无法写入文件
• 当前安装的expo CLI版本与Node 16存在兼容性问题

解决建议 #

按以下优先级依次尝试：

1. 强制清理npm缓存后重新执行初始化命令

npm cache clean --force
expo init awesomeProject

2. 切换npm源为国内镜像，解决境外资源访问失败问题

npm config set registry https://registry.npmmirror.com
expo init awesomeProject

3. 修复权限问题：不要在系统受保护路径下创建项目，右键点击终端选择「以管理员身份运行」后重新执行命令。
4. 安装兼容Node 16的expo CLI版本后重试，最新版expo CLI对Node 16的适配存在已知兼容问题，可安装经过验证的稳定旧版本：

npm uninstall -g expo-cli
npm install -g expo-cli@6.3.10
expo init awesomeProject

5. 若以上方案均无效，可手动创建项目结构：新建目标文件夹后手动执行npm init初始化项目，安装expo相关依赖，参照官方最小配置手动编写app.json文件即可跳过模板拉取步骤。

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