create-react-app创建项目提示package.json缺失依赖如何解决

Windows环境下执行create-react-app抛出Missing dependencies in package.json报错，仅生成package.json文件，核心诱因有三类：

• 路径兼容问题：项目存储路径、Windows系统用户名包含中文、空格或其他非ASCII特殊字符，create-react-app的依赖写入逻辑对非纯英文路径兼容存在缺陷，无法将已安装的依赖正确写入package.json文件，这是该问题最高发的原因。你之前尝试的清空缓存、重装Node/VS Code等操作未生效，基本是因为没有排查到这类路径问题。
• npm环境异常：npm缓存损坏、安装源配置异常，会导致依赖拉取不全，触发依赖缺失校验。
• 版本兼容问题：你使用的Node v16.16搭配npm v8.13.2存在已知兼容bug，npm 8.13.x版本在Windows平台下的文件写入逻辑存在缺陷，会偶发依赖字段写入失败。

按以下优先级逐一操作，即可解决问题：

1. 排查路径问题

• 将项目移动到全英文、无空格、无特殊符号的路径下，不要存放在桌面、我的文档等包含中文用户名的系统目录中，推荐直接放在磁盘根目录的纯英文文件夹下，例如D:\dev\react-projects。
• 如果你的Windows系统登录用户名是中文，必须新建一个纯英文命名的系统管理员账户，切换到新账户后再执行创建操作，中文系统用户名是Windows下前端开发环境异常的高频诱因。

2. 修复npm环境

• 先全局卸载残留的旧版本create-react-app，避免本地缓存版本干扰：
  npm uninstall -g create-react-app
• 强制清空npm全量缓存：
  npm cache clean --force
• 切换npm到稳定的安装源，避免源同步不全导致的依赖拉取异常：
  npm config set registry https://registry.npmmirror.com

3. 处理版本兼容

• 将npm升级到修复了Windows写入bug的稳定版本：
  npm install -g npm@8.19.4
• 执行创建命令时显式指定使用npm作为包管理器，避免npx自动识别出错：
  npx create-react-app myapp --use-npm

4. 替代方案
   如果上述操作后仍然创建失败，可以直接使用Vite创建React项目，不存在create-react-app的Windows兼容问题，创建速度更快，执行以下命令即可：
   npm create vite@latest myapp -- --template react
   创建完成后进入项目目录执行npm install安装依赖，再执行npm run dev即可启动开发服务器。

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