You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

创建Next.js应用时遭遇TAR_BAD_ARCHIVE错误及弃用警告

解决npx create-next-app创建应用时的TAR_BAD_ARCHIVE错误

试试这些方法解决问题:

  • 彻底删除npm缓存目录
    手动删掉C:\Users\<username>\AppData\Local\npm-cache整个文件夹,比npm cache clean --force更彻底,能清除所有可能损坏的归档文件残留。

  • 更换npm镜像源
    网络问题常导致下载的归档文件损坏,切换到国内镜像:

    npm config set registry https://registry.npmmirror.com/
    

    之后重新执行创建命令:

    npx create-next-app@latest my-next-app
    
  • 换用其他包管理器
    如果npm始终有问题,试试yarn或pnpm:

    • 使用yarn:
      yarn create next-app my-next-app
      
    • 使用pnpm:
      pnpm create next-app my-next-app
      
  • 手动初始化Next.js项目
    直接拉取官方模板来创建:

    git clone https://github.com/vercel/next.js.git
    cd next.js/examples/hello-world
    npm install
    

    也可以去Next.js官网下载模板压缩包,解压后手动执行npm install完成初始化。

  • 检查磁盘权限
    确认当前用户对要创建项目的目录有读写权限,避免解压归档时因权限不足导致损坏。

内容的提问来源于stack exchange,提问作者Vladimir Davtyan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.16 02:22:07