Nuxt脚手架nuxi初始化失败原因&解决方法 - wuuconix's blog

起因

前几天终于把毕业设计的开题报告整完了，有了一点时间干自己的事，于是就想着学学nuxt3。

结果发现跟着官方教程敲的第一行命令就出现了问题。

npx nuxi init nuxt3-app

这行代码是nuxt的脚手架，会生成一个最简单的模板项目。

脚手架报错

这行命令会去github拉取相关文件，然后连接失败报错了。

国内由于墙的墙的原因，raw.githubusercontent.com这个域名受到了DNS污染，没法连接看好像挺合理的，但是关键我平时都是开着代理的。

curl能够正常获取

如图所示，我直接用curl没有一点问题，能够正确获取 raw.githubusercontent.com 上的文件。

看来，唯一的解释就是脚手架node程序没有走代理。

原因的确认

经过简单搜索，我在nuxt framework仓库中的issue #8002 找到了类似情况。

从中可以了解到 nuxt的脚手架 nuxi 使用了 giget 来从nuxt项目模板仓库中获取文件。

giget干的事情很简单，就是利用node从github上拉取相应仓库。实际上giget貌似是nuxt团队对另一个相似的项目degit的拙劣仿制。

两者都可以用方便的命令从github拉取仓库。

唯一的不同就是degit支持自动从环境变量中获取https_proxy进行代理，而giget完全没有考虑这一点。

HTTPS proxying If you have an https_proxy environment variable, Degit will use it.

degit和giget对比

临时解决办法

目前nuxt社区已经注意到了此情况，在giget中提出了相关issue，而且有一个大佬已经提交了相关PR。

PR opened 2 days ago

可惜PR已经提出2天了，也没有相关回复，并入giget仓库不知道还要花多久。

这里我给出两个解决办法

(1)手动克隆模板仓库

其实，从之前我们也知道了，所谓的脚手架实际上就是拉去nuxt项目模板仓库中的文件。

所以我们只需要手动git clone即可。

git clone -b v3 https://github.com/nuxt/starter.git nuxt3-app

-b 是指定分支，目前最新的nuxt3在v3分支。

git clone

(2)使用支持https代理的degit

degit 'nuxt/starter#v3' nuxt3-app

#v3代表下载相应分支。

degit

这里我更推荐使用degit，因为代码量少，而且degit拉取的项目中不包含模板仓库的.git目录。

思考：node程序如何支持代理

观察那位大佬提交的PR可以看到，他使用了https-proxy-agent实现代理。

PR detail

这里对https-proxy-agent做了简单试用。

代码: https://stackblitz.com/edit/node-zwkzaa?embed=1&file=index.js

不适用代理的情况：

使用代理的情况: