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的功能的确很强大, 还可以继续挖掘更多的功能,假如还有部署方面的问题,可以评论区留言, 一起可以探讨一下。

相关推荐
薛定e的猫咪10 小时前
Vibe Coding范式实战:用AI工具链(Stitch+Figma+ai studio+Trae)快速开发全栈APP
前端·人工智能·react.js·github·figma
折七10 小时前
2026 年 Node.js 后端技术选型,为什么我选了 Hono 而不是 NestJS
前端·后端·node.js
下北沢美食家10 小时前
Express框架入门
开发语言·javascript·express
毕设源码-钟学长10 小时前
【开题答辩全过程】以 基于Vue的租房App为例,包含答辩的问题和答案
前端·javascript·vue.js
CappuccinoRose10 小时前
HTML语法学习文档 - 汇总篇
前端·学习·html5
a11177612 小时前
星球主题个人主页(纯HTML 开源)
前端·html
旭日跑马踏云飞12 小时前
【Nginx】相关优化
运维·javascript·nginx
空条jo太郎12 小时前
echarts图表联动
前端
webkubor12 小时前
2026 年 把网页交互的主控权拿回前端手中 🚀
前端·javascript·人工智能
Lee川12 小时前
Promise:驾驭 JavaScript 异步编程的艺术
javascript