Nuxt 3 安装失败的原因及解决方法

问题描述

按照 Nuxt 官方文档进行项目初始安装:

bash 复制代码
$ npx nuxi@latest init <project-name>

但在国内的网络,由于众所周知的原因,会报错:

bash 复制代码
Error: Failed to download template from registry: Failed to download https://raw.githubusercontent.com/nuxt/starter/templates/templates/v3.json: TypeError: fetch failed

但是加上科学上网之后,仍然是会报错,根据相关的 issue 这是因为 node 的 https 模块在使用科学上网时会有一定的冲突,可以通过以下命令来验证:

ruby 复制代码
$ node -e "require('https').get('https://raw.githubusercontent.com/nuxt/starter/templates/templates/v3.json')"
# 结果会报错

解决方法

虽然使用 cli 方式安装 nuxt 会失败,但是也可以通过手动方式来安装:

首先,先确认上述报错的连接是否能在浏览器打开,打开后,请求会返回一个 json:

json 复制代码
{
    name: "v3",
    defaultDir: "nuxt-app",
    url: "https://nuxt.com/",
    tar: "https://codeload.github.com/nuxt/starter/tar.gz/refs/heads/v3"
}

其中,tar 字段就是项目初始文件的下载地址,下载对应的 starter-3.tar.gz 包到本地,并创建项目文件夹:

bash 复制代码
# 创建项目目录
$ mkdir -p /path/to/project
# 移动 nuxt 初始文件包到项目目录
$ mv /path/to/file/starter-3.tar.gz /path/to/project
# 进入项目目录
$ cd /path/to/project
# 解压文件包
$ tar -zxvf starter-3.tar.gz
# 重命名 nuxt 项目目录
$ mv starter-3 my-nuxt
# 进入 nuxt 项目目录
$ cd my-nuxt
# 安装依赖(推荐 pnpm)
$ pnpm install
# 启动项目
$ pnpm dev

如果一切顺利,你将在浏览器里看到 nuxt 的欢迎界面:

(全文完)

相关推荐
kyriewen30 分钟前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang44 分钟前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志2 小时前
如何让 AI 高效工作
前端·后端·ai编程
FRing033 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷3 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜3 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
Yk酱228403 小时前
A2UI随笔-demo-01
前端
云起SAAS3 小时前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端
奶油话梅糖4 小时前
3 天 1,705 Star:DeepSeek 开源官方聊天前端——零后端纯静态,浏览器直连 API
前端·开源
Linye4 小时前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能