之前博客用的静态网页生成器是Jekyll，因为我是用 Github Page 托管的，默认支持的框架就是 Jekyll 。但是因为对之前的主题不是很满意，于是瞄向了 Hugo-stack ，使用的人很多，有很多可以抄的作业和很美的装修，此外，因为 Hugo是 Go 开发的，编译型语言生成速度很快！（但个人体验其实差别没有非常大，可能适合ADHD（？😹））

其实还有一个很重要优点，就是可以把主题拉取存放在一个目录下，方便切换，但是因为我装修改动挺大，按常规操作出现了一些问题，懒得解决，于是干脆把主题拉下来，直接在样例的基础是修改！方便多啦！

五一的时候花了一天时间把我的博客改造成了 Hugo，现在也算是稳定运行啦，希望我可以坚持写作！

下面就是一些我遇到的小坑，其实都没有很难解决，但还是分享下吧！

使用 GitPage 托管，推送代码后网页仍显示404？

出现这个问题可能是和我一样心急，没有好好看文档😂

但是没关系，因为其实在 Hugo 的目录结构中，public目录下才是生成的发布文件，所以只需要把public目录下生成的内容 push 到 Github Page 仓库下就可以噜！

当然也可以看官方文档这里，提到了设置了 Github Action 的方案👉Host on GitHub Pages | Hugo

已经修改了baseurl，为什么我的xml文件里还都是localhost？

这个更好解决，如果在config.yaml中已经修改了baseurl，但是生成的index.xml或sitemap中还是会出现类似这样的情况：

1
2
3
4

<url>
    <loc>http://localhost:1313/</loc>
    <lastmod>2025-05-01T00:00:00+00:00</lastmod>
</url>

只需要运行hugo命令重新生成一遍就可以了，注意不是hugo server！

引入的Neodb卡片无法显示？

关于引入Neodb卡片的短代码，我参考了这位友的博客，非常有用细致！👉Hugo Stack 主题装修笔记 Part 3

出现无法显示的问题可能是因为肉身在墙内。如果使用的是Clash，可以开启TUN模式，保证你的localhost也可以被代理，方便本地生成查看效果。

TBC.