博客从hexo迁移到hugo

· 2 min read

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

https://static.1991421.cn/2025/2025-04-30-202206.jpeg

具体步骤

安装hugo

brew install go

brew install hugo

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

使用hugoblox

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

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

主题定制

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

这里举几个例子

  1. 开启站内检索
  2. favicon图标
  3. 分享按钮 等等,设置项很多。

hexo 文章迁移到hugo下

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

  1. hexo 元数据description修改为summary

  2. hexo 元数据addrlink修改为slug

  3. hugo配置文件url规则修改。

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

补充问题

安装低版本hugo

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

https://static.1991421.cn/2025/2025-05-01-165752.jpeg

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

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

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

https://static.1991421.cn/2025/2025-05-01-170705.jpeg

写在最后

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

相关文档