解决Nuxt3项目创建项目失败链接失败等问题

问题:创建 Nuxt 3 项目卡在网络

用 npx nuxi init my-app 创建新项目时,经常卡在拉模板这一步。控制台报错通常是:

• fetch failed
• Error: ENOTFOUND raw.githubusercontent.com
• connect ETIMEDOUT 185.199.108.133:443

这是 GitHub 提供的几个域名(raw.githubusercontent.com、github.io、codeload.github.com)在中国大陆访问极不稳的老问题。DNS 解析能拿到 IP,但 IP 本身被劫持或者干脆 ping 不通。

方案 1:改 hosts 直接绑定可用 IP

原理:让本机 DNS 强制走某个能 ping 通的 IP,绕开本地运营商 DNS 污染。

Windows 上,管理员身份打开记事本,编辑:

C:WindowsSystem32driversetchosts

文件末尾加一行:

185.199.108.133 raw.githubusercontent.com

保存后,新开终端,ping raw.githubusercontent.com 看是否能通。

macOS / Linux 上,sudo 编辑 /etc/hosts:

sudo nano /etc/hosts
# 或者
sudo vi /etc/hosts

加同一行。改完立即生效:

# macOS 刷新 DNS 缓存
sudo killall -HUP mDNSResponder

# Linux
sudo systemd-resolve --flush-caches

怎么找可用 IP

185.199.108.133 不一定一直能用,GitHub IP 也会变。可以用以下站点查:

• ipaddress.com —— 搜域名直接出 IP 列表
• GitHub520 项目 —— 维护了 GitHub 系列域名的可用 IP,定期更新整套 hosts

GitHub520 的 hosts 一键替换,覆盖 github.com、api.github.com、raw.githubusercontent.com、github.io、objects.githubusercontent.com、codeload.github.com 全套:

# GitHub520 Host Start
140.82.121.4               github.com
185.199.108.133            raw.githubusercontent.com
185.199.108.133            user-images.githubusercontent.com
185.199.108.133            avatars.githubusercontent.com
185.199.108.133            github.io
185.199.108.154            github.githubassets.com
20.205.243.166             codeload.github.com
20.205.243.168             api.github.com
185.199.108.133            objects.githubusercontent.com
# GitHub520 Host End

方案 2:用代理服务

不想动 hosts 的话,用代理服务:

2a. ghproxy 代理(对 raw.githubusercontent.com 友好):

# 设置 giget(nuxi 内部用的工具)走代理
export GIGET_GITHUB_URL=https://ghproxy.com/https://github.com
npx nuxi init my-app

2b. 命令行的 HTTP/TLS,在 HTTP 之上加一层 TLS 加密,防止中间人窃听和篡改。">HTTPS 代理变量(如果你有 v2ray / clash 本地代理):

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
npx nuxi init my-app

跑完记得 unset:

unset http_proxy https_proxy

方案 3:手动 clone 模板

nuxi 拉的就是 nuxt/starter 仓库,你自己 clone 一下也行:

git clone https://github.com/nuxt/starter --branch v3 my-app
cd my-app
rm -rf .git
npm install
npm run dev

git 本身有自己的代理设置,跟 hosts 联动,如果上面 hosts 改完通了,这一步也通。

验证 hosts 是否生效

# 看 DNS 解析到的 IP 是不是你 hosts 里写的
nslookup raw.githubusercontent.com

# 或者
ping raw.githubusercontent.com
# 应该显示 185.199.108.133(或者你 hosts 里设的)

不生效常见原因:

• 没用管理员身份编辑 hosts(Windows 上保存会失败)
• 编辑后没刷新 DNS 缓存
• 浏览器有自己的 DNS 缓存,要全部关掉重开
• VPN 工具开着的话,它会接管 DNS 解析,hosts 不一定生效

给 npm 也换源

hosts 解决了拉模板的问题,但接下来 npm install 几十兆的 node_modules 也慢,顺手把 npm 源也换了:

npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry

这样整个项目创建到启动的全流程都顺。

长远建议

开发机器上 hosts 加 GitHub520 这一套 + 把 npm 换淘宝源,基本能解决 90% 国内开发遇到的 npm / git 网络问题。如果做得多,推荐:

• 用 SwitchHosts 这种 GUI 工具管理 hosts,可以多组配置切换
• 用 nrm 管理 npm 源,nrm use taobao 一键切
• 团队项目根目录放个 .npmrc 文件,直接指定源,新人 clone 完就能用

# .npmrc
registry=https://registry.npmmirror.com

—— 别看了 · 2026