2026年02月26日 星期四 阴

之前的问题

  • public 目录在 Git 中（170MB / 4700 文件）→ 每次部署需要上传大量文件，导致超时
  • Framework 设为 Other → Vercel 不知道如何处理 Hugo 项目

做的修改

改动 作用
从 Git 移除 public/ 目录 仓库从 170MB 缩小到几 MB，克隆更快
添加 vercel.json 指定 Hugo 0.101.0 确保和本地版本一致，避免兼容性问题
Framework 改为 Hugo Vercel 自动处理 Hugo 编译
Build Command 去掉 --minify 避免代码块解析错误

最终配置

vercel.json：

{ “build”: { “env”: { “HUGO_VERSION”: “0.101.0” } } }

这个版本和我本地编译的Hugo版本一致。

Vercel 项目设置：

  • Framework: Hugo
  • Build Command: hugo -D
  • Output Directory: public

“概率性"编译失败问题

中间遇到的 socket hang up 确实是网络抖动，重试就好了。但主要的改动（移除 public、指定 Hugo 版本）是解决超时问题的根本原因。

现在每次只需要推送 Markdown 文件，Vercel 用 6-7 秒编译完成，比之前快多了！

小结

只上传md，不上传编译的输出文件，感觉还是不错的，至少成功了，我不确定每次都会成功，所以写一篇触发编译试试