运行npx create-react-app创建React应用时持续报版本过旧的全局安装报错如何解决

核心原因 #

报错反复触发基本都是三类残留导致的：

• npx 本地缓存留存旧版安装包
• 当前工作目录存在本地安装的旧版 create-react-app
• npm/yarn/pnpm 的全局安装卸载未完全清理

分步解决操作 #

• 强制清除npx依赖缓存
  npx 默认优先调用本地缓存的安装包，哪怕全局包已卸载，缓存中留存的 4.0.1 旧版本会被直接触发，不会自动拉取最新版。执行以下命令清空缓存：

  npm cache clean --force
  # 若使用yarn/pnpm触发命令，额外执行对应清缓存命令
  yarn cache clean
  pnpm store prune
  

• 彻底清理所有渠道的残留安装
  无论之前通过包管理器还是手动安装的，逐渠道执行卸载避免残留：

  npm uninstall -g create-react-app
  yarn global remove create-react-app
  pnpm uninstall -g create-react-app
  

  额外排查当前工作目录的本地残留：

  # 查看当前目录是否安装了旧版create-react-app
  npm ls create-react-app
  # 若有输出，执行卸载
  npm uninstall create-react-app
  

  Windows环境补充：若全局卸载不生效，可通过 npm config get prefix 查询npm全局安装路径，手动删除路径下所有和 create-react-app 相关的文件夹。
• 强制调用最新版完成初始化
  操作完上述步骤后，直接指定最新版本执行初始化，完全绕开本地缓存和残留旧包：

  npx create-react-app@latest my-app
  # 若仍触发旧版本，加--ignore-existing参数强制忽略所有本地已存在的旧包
  npx --ignore-existing create-react-app@latest my-app
  

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