0%

关于hugo部署到vercel的补充

开头

前几天,我安装完hugo,想上传到github,然后部署到Vercel时,出现的几个错误,在此相合大家分享一下

关于Github Pages和Vercel

为什么部署到Github Pages上,却用了Vercel,因为Github Pages目前有两个小问题:

  • 国内访问慢,有些地区访问Github Pages可能超时。
  • Github禁止百度抓取网页,意味着你的网站没办法在百度上搜到。

Vercel 它是一个免费的网站托管平台,不仅仅可以部署静态网站,而且还可以部署动态网站,所以我们可以拿 vercel 充当你免费的服务器,是非常好用的。

  • 关联 github,只需要往 github 提交代码,它会自动获取最新的提交,然后自动部署
  • 提供了免费的域名,省去了申请域名的问题,如果有自己的域名,还可以做个域名解析到这个平台上
  • 提供了免费的 Https 证书,如果证书到期了,它会自动替换,傻瓜式的部署方式,它的操作非常简单

错误

直接进入主题,我在部署的流程之中遇到过的错误,也是需要注意的点

错误一:输入命令

描述:运行 Hugo Version 命令,但是显示 hugo command not found 报错

解决方法:检查环境变量是否输入正确。注意路径不包含hugo.exe,路径只需要写到包含hugo.exe的文件夹即可。

错误二:Github上传

描述:文件上传不全,themes主题文件没有上传成功,github仓库中只有主题的软连接

解决方法一:主题如果是从github下载下来的,子目录里面会有 .git 文件,发布代码的话,内层目录是不能有.git的,它会识别成另一个git仓库并忽略上传,只上传一个软链接文件。所以需要删除themes主题下面的.git文件,否则 Vercel 无法从 github上拉取到主题,编译会失败。
注意:如果找不到.git文件,在查看中找到显示,将隐藏的项目打勾即可

解决方法二:还有一种可能是.gitignore文件的问题,检查 Github 仓库是否正确上传了主题文件夹?如果在仓库里找不到主题文件夹,那么删掉.gitignore,.gitignore的作用是让 Git 忽略文件中提到的提交,有可能导致主题文件夹没有推送到 Github,因此报错。