hugo部署vercel踩坑记录

hugo和vercel都是什么?

hugo是一个静态博客框架, Vercel 是一个提供静态网站和 Serverless 函数部署的云平台,Vercel 提供了与 GitHub 的深度集成,你只需要通过几次点击就可以将你的 GitHub 项目部署到 Vercel 上, Vercel 提供了全球 CDN,可以确保你的网站在全球范围内都有优秀的加载速度。Vercel 提供了丰富的开发者工具,如 CLI 工具、集成的环境变量管理、日志查看等

第一坑 hugo皮肤下载和submodule

假如你不是自己去写皮肤模版,也不想用hugo默认的, 只想使用一些现成的模版, 你就想当然就themes目录下执行git clone 皮肤模版地址, 最好不要这么做, 因为你自己的博客项目也是git托管的, 你在一个git项目下再去克隆一个git项目,这其实形成了一个父子关系, 你会发现, 父级项目的git不会去追踪子项目的文件,其实也很好理解, 父应用只需要保存子应用的git地址, 这样两者可以解耦, 两个git项目互不影响, 这里可以执行以下这个命令

bash 复制代码
git submodule add https://github.com/username/theme-name themes/theme-name

这个命令执行完, 项目目录就是这个样子了

.submodules里面记录了子git项目的path和git托管地址

ini 复制代码
[submodule "themes/PaperMod"]
	path = themes/PaperMod
	url = https://github.com/adityatelange/hugo-PaperMod

第二坑 vercel打包是一堆xml文件

这个错误源自于皮肤模版没有正常加载所导致的, 我们需要override vercel的打包命令, 在vercel控制台点击设置 然后重新redeploy一下

第三坑 vercel hugo版本问题

假如第二坑还是没有解决的话可能就是vercel自身hugo版本的问题了, 在vercel中hugo不像node版本可以直接选择, vercel中的Hugo版本应该挺老的, 我们可以设置环境变量,我查了一下,现在最新版本是0.114.0

好了,可以再redeploy一下, 终于成功了

后言

以前不知道,vercel的功能的确很强大, 还可以继续挖掘更多的功能,假如还有部署方面的问题,可以评论区留言, 一起可以探讨一下。

相关推荐
清汤饺子5 小时前
OpenClaw 本地部署教程 - 从 0 到 1 跑通你的第一只龙虾
前端·javascript·vibecoding
颜酱5 小时前
图的数据结构:从「多叉树」到存储与遍历
javascript·后端·算法
爱吃的小肥羊7 小时前
比 Claude Code 便宜一半!Codex 国内部署使用教程,三种方法任选一!
前端
IT_陈寒8 小时前
SpringBoot项目启动慢?5个技巧让你的应用秒级响应!
前端·人工智能·后端
树上有只程序猿9 小时前
2026低代码选型指南,主流低代码开发平台排名出炉
前端·后端
橙某人9 小时前
LogicFlow 小地图性能优化:从「实时克隆」到「占位缩略块」!🚀
前端·javascript·vue.js
高端章鱼哥9 小时前
为什么说用OpenClaw对打工人来说“不划算”
前端·后端
大脸怪9 小时前
告别 F12!前端开发者必备:一键管理 localStorage / Cookie / SessionStorage 神器
前端·后端·浏览器
Mr_Mao9 小时前
我受够了混乱的 API 代码,所以我写了个框架
前端·api
小徐_23339 小时前
向日葵 x AI:把远程控制封装成 MCP,让 AI 替我远程控制设备
前端·人工智能