nuxt安装报错-网络问题

Error: Failed to download template from registry: Failed to download raw.githubusercontent.com/nuxt/starte...: TypeError: fetch failed

方法 1：使用国内镜像源（推荐）

原理：将 GitHub 的 raw.githubusercontent.com 替换为国内加速镜像地址。

步骤：

查找镜像域名

访问 ipaddress.com/website/raw... 获取最新的可用 IP 地址（选一个低延迟的）。
修改 hosts 文件
- Windows ：
  
  用管理员权限打开 C:\Windows\System32\drivers\etc\hosts，添加：
  复制代码
```
185.199.108.133 raw.githubusercontent.com
```
  （IP 替换为查找到的最新地址）
- Mac/Linux ：
  
  终端执行：
  bash 复制代码
```
sudo nano /etc/hosts
```
  添加相同内容，保存后刷新 DNS：
  复制代码
```
sudo dscacheutil -flushcache
```
重试安装命令
lua 复制代码
```
npx create-nuxt-app my-project
```

方法 2：手动下载模板 + 本地安装

原理：绕过在线下载步骤，直接使用本地文件。

步骤：

手动下载模板文件

浏览器访问以下 URL（或使用其他网络下载）：
cdn.jsdelivr.net/gh/nuxt/sta...

保存为 v3.json 到本地（如 ~/Downloads/v3.json）。

创建 Nuxt 项目时指定本地路径

perl 复制代码

npx create-nuxt-app my-project --template local:~/Downloads/v3.json

或

perl 复制代码

npx create-nuxt-app my-project --template https://cdn.jsdelivr.net/gh/nuxt/starter@templates/templates/v3.json

方法 3：使用代理环境变量

原理：强制 Node.js 走代理通道（适合已配置代理的情况）。

步骤：

ini 复制代码

# 设置代理（端口根据你的代理工具修改）
export HTTPS_PROXY=http://127.0.0.1:7890  # Linux/Mac
set HTTPS_PROXY=http://127.0.0.1:7890     # Windows CMD

# 重试安装
npx create-nuxt-app my-project

方法 4：更换 npm/yarn 镜像源

原理：解决依赖包下载问题（可能连带触发模板下载失败）。

bash

复制

下载

arduino 复制代码

# 切换淘宝源
npm config set registry https://registry.npmmirror.com
# 或
yarn config set registry https://registry.npmmirror.com

终极方案：完整离线包

如果上述方法均失效，直接下载官方 starter 模板：

访问 github.com/nuxt/starte... → 点击 "Use this template" → 下载 ZIP。
解压后进入目录，执行：
arduino 复制代码
```
npm install
npm run dev
```

验证是否解决

检查网络连通性（测试是否能访问）：
arduino 复制代码
```
curl -v https://raw.githubusercontent.com
```
清除 npm 缓存：
css 复制代码
```
npm cache clean --force
```

注意：优先尝试 方法 1（修改 hosts） 或 方法 2（手动下载） ，成功率最高。如遇持续问题，可能是临时性 GitHub 服务故障，稍后重试即可。