Hello! 欢迎来到小浪资源网!



如何在 Vercel 中托管 Hugo


我决定和hugo一起建立我的个人网站。我的选择唯一基于的是构建时间。我认为 hugo 在内容管理方面与 astro 处于同一水平,但目前还没有达到这个水平。或者,我可以说它有自己的路径,因为它比我遇到的大多数其他静态站点生成器都要旧。此外,它是一个 go 应用程序,这是评估技术选择时要考虑的另一个重要因素。

可以添加什么!

是的,可以扩展hugo的功能。您可以通过修改构建过程的模块添加缺失的功能。例如,我缺少 hugo 中的 mdx 支持。我可以通过在构建时渲染 mdx 的模块来解决这个问题。我自己没有尝试过,但似乎是可能的。
我还可以添加一个并行构建管道——如果我们可以这样称呼它的话。这可能涉及使用 vite、turbo 或 webpack 等工具。然而,这种方法可能会使构建过程复杂化,并可能减慢 hugo 的主要构建机制。这些集成已用于合并 tailwind 和其他前端库。有趣的是,如果您查看 hugo 即将推出的功能,您会看到集成 tailwind 和其他技术的计划。

基于 vercel 构建

我使用了一些第三方 hugo 工具,特别是 hugomods。图标模块引起了我的注意,因为我想向我的网站添加图标而不导入整个字体。在搜索时,首先出现的是图标模块。它提供了各种图标供应商,包括 bootstrap、font awesome、feather 图标等等。
在当地,一切都很顺利。然而,在推动我的改变之后,似乎没有任何改变。在检查 vercel 中的构建页面后,我注意到…

[12:10:48.021] running build in washington, d.c., usa (east) – iad1 [12:10:48.210] cloning github.com/mohessaid/mohessaid (branch: main, commit: eaeecd1) [12:10:48.449] cloning completed: 238.727ms [12:10:49.038] restored build cache from previous deployment (5i5scdjny3kzxggbqbqfgjujrwyb) [12:10:49.132] running "vercel build" [12:10:49.714] vercel cli 39.0.2 [12:10:50.440] total in 3 ms [12:10:50.441] error: failed to load modules: failed to download modules: binary with name "go" not found in path [12:10:50.446] error: command "hugo --gc" exited with 1 [12:10:50.625] 

当 hugo 尝试安装构建所需的模块时,它找不到 go 二进制文件。我向claudegpt寻求帮助,希望能够快速解决问题,但他们无法提供直接帮助。我必须引导他们完成每一步,最终,我对他们帮助我的能力失去了希望。
如果不是因为 vercel 输入字段的限制,我什至使用 claude 来实现几乎成功的解决方案。

什么有效?

我在 vercel 仪表板中导航至我的网站的设置页面。在“环境变量”选项卡中,我添加了一个名为“hugo_version”的变量,并将其值设置为最新可用的 hugo 版本。

如何在 Vercel 中托管 Hugo

在“常规”选项卡中,选择 hugo 作为框架预设。然后使用以下内容覆盖构建命令:

curl -L https://go.dev/dl/go1.22.2.linux-amd64.tar.gz -o go1.22.2.linux-amd64.tar.gz && tar -C /usr/local -xzf go1.22.2.linux-amd64.tar.gz && export PATH=$PATH:/usr/local/go/bin && go env GOTPATH  &&  hugo --gc --minify  

如何在 Vercel 中托管 Hugo

注意:我使用的是 go 版本 1.22.2,这是撰写本文时的最新版本。您可以修改版本以满足您的具体要求。

为什么要构建命令?

我理解你的怀疑。和你一样,我认为我有一个聪明的解决方案。最初,我尝试在 install command 字段中安装 go,但惨败。尽管我进行了详尽的故障排除,但 vercel 的构建过程仍无法找到二进制文件。
在探索了无数潜在的解决方案但没有成功之后,我偶然发现了一个 github 问题,其中有人将整个安装过程直接放在构建字段中。照着他们的方法,我终于获得了成功。至此,解决方案就说明了一切。
尝试将这些步骤放入安装命令字段中可能会导致错误。

如何在 Vercel 中托管 Hugo

或者这个

如何在 Vercel 中托管 Hugo

安装 amazon linux extras 并不能解决 go 安装难题。通过此方法可用的 go 版本明显过时。我彻底测试了这种方法并遇到了一致的失败。我尝试在安装命令中同时使用 yum 和 dnf 包管理器,但这两种方法都没有成功解决 go 二进制问题。


最后,我在不同的平台上分享了这篇文章,以测试哪个平台在搜索结果中排名第一。几个月前我就愿意这样做。但是,我找不到合适的帖子。您可以从这里开始进行实验。

相关阅读