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

相关推荐
Bigger5 分钟前
后端拒写接口?前端硬核自救:纯前端实现静态资源下载全链路解析
前端·浏览器·vite
BD_Marathon20 分钟前
【JavaWeb】路径问题_前端绝对路径问题
前端
whyfail1 小时前
Vue原理(暴力版)
前端·vue.js
Bigger1 小时前
Coco AI 技术演进:Shadcn UI + Tailwind CSS v4.0 深度迁移指南 (踩坑实录)
前端·css·weui
踢球的打工仔1 小时前
jquery的基本使用(3)
前端·javascript·jquery
前端无涯1 小时前
Trae的使用
前端·ide·trae
WG_171 小时前
Linux:进程控制
前端·chrome
[seven]1 小时前
React Router TypeScript 路由详解:嵌套路由与导航钩子进阶指南
前端·react.js·typescript
无我Code2 小时前
前端-2025年末个人总结
前端·年终总结