博客从hexo迁移到hugo

· 2 min read

博客使用hexo已9年，虽然hexo还活着，但hexo主题匮乏，视觉疲劳，且定制成本还是太高了。因此这里借着假期，我决定尝试把迁移到hugo。

具体步骤

brew install go

brew install hugo

注意，hugo版本过高有时会有报错情况，以我这里为例，在使用hugoblox时出现hugo启动报错，最终解决办法是下载安装hugo@0.134.2。如果大家遇到奇怪的报错问题，可以考虑降级解决。

hugoblox是个高级框架，这里使用hugoblox来简化主题的定制和开发功能。它提供了丰富的功能和灵活的定制选项，适合各种需求。

访问hugoblox主题库，选择主题，注意如果是付费的主题，并没有编辑按钮，是需要单独购买。这里我选择了免费的主题，点击Edit，会跳转到GitHub。在GitHub下点击基于模版创建仓库。创建OK后，剩下的工作就是主题配置了。

本地git拉取创建的仓库。参考官方教程可以进行部分简单的定制修改。

这里举几个例子

主题配置完成后，接下来是博客迁移，因为我的站点已运行多年，搜索引擎和其它平台也有收录了URL，因此需要保持原有的URL不变，这里就有一些工作要做。

hugo配置文件url规则修改。

permalinks:
blog: '/:year/:month/:day/:slug/'    # 输出: /2025/04/30/my-post/

brew等包管理器下并没有低版本hugo，上述版本错误出现时需要手动安装指定版本。这里推荐直接GitHub下载指定版本tag下的二进制包，比如Mac的话，下载darwin-universal.tar.gz

执行如下命令拷贝到目标目录

 mv $HOME/Desktop/hugo_0.134.0_darwin-universal/hugo /opt/homebrew/bin/

执行会提示安全风险，隐私安全中，选择打开。之后即可正常使用，比如输入hugo version，查看版本号。

到此博客就迁移完成了，总耗时1天。