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

相关推荐
Highcharts.js12 分钟前
什么是向量图表?如何用 Highcharts 快速创建一个笛卡尔坐标图/矢量图?
javascript·开发文档·highcharts·图表开发·向量图·矢量图表·笛卡尔坐标图
NEXT0636 分钟前
React 闭包陷阱深度解析:从词法作用域到快照渲染
前端·react.js·面试
脱离语言1 小时前
Jeecg3.8.2 前端经验汇总
开发语言·前端·javascript
NEXT061 小时前
useMemo 与 useCallback 的原理与最佳实践
前端·javascript·react.js
小爱丨同学1 小时前
React-Context用法汇总 +注意点
前端·javascript·react.js
徐同保2 小时前
python如何手动抛出异常
java·前端·python
极客小云2 小时前
【实时更新 | 2026年国内可用的npm镜像源/加速器配置大全(附测速方法)】
前端·npm·node.js
半兽先生3 小时前
告别 AI 乱写 Vue!用 vue-skills 构建前端智能编码标准
前端·vue.js·人工智能
木易 士心3 小时前
ESLint 全指南:从原理到实践,构建高质量的 JavaScript/TypeScript 代码
javascript·ubuntu·typescript
前端达人3 小时前
都2026年了,还在用Options API?Vue组合式API才是你该掌握的“正确姿势“
前端·javascript·vue.js·前端框架·ecmascript