Hugo 博客搭建指南
写在前面 这是这个新博客的第一篇文章。 从 22 年至今,我已搭建过三次博客。每一次都是技术探索与折腾的过程:从 Typecho 到 Halo,从 LNMP 架构到 Docker 部署……经历了无数次配置调试与反复取舍。 一路走来,我的心态也在悄然发生变化:曾经执着于博客的技术架构与视觉效果,而现在,我更加重视写作本身的意义。 在一次一次的键盘敲击中,将思绪梳理成文字,将技术沉淀为知识。用合适的方式表达自我,输出有价值的内容。这才是 Blog 的意义所在。 这一次,我再次找回最初那份搭建博客的初心与动力,将这个新的博客搭建了起来。 希望这个博客能长久地运营下去吧。: ) 花了半个月时间,参考了许多网上的优秀实践,并结合自己的需求进行了功能整合与定制,搭建了这么一个令我较为满意的博客。 在记忆尚新的当下,于此记录搭建博客的细节。这既是为自己留下的总结与备忘,也希望为后来者提供一些参考,少走一些弯路。 开发过程均已提交 Github:项目源码 为什么是 Hugo? 私以为,对于个人开发者而言,动态博客的一些复杂功能——如用户系统、权限管理,性能监控等——显得较为多余。毕竟,写作的核心在于内容本身。 Hugo 是一个 Go 语言编写、开源的静态网站生成器。它构建速度极快,语法简洁,功能丰富,社区活跃,具备高度的灵活性和可扩展性。这些特性使得它成为搭建个人博客的理想选择。 Hugo 入门 安装 从 Github Releases 内下载适用于你系统的软件包、二进制可执行文件,或直接直接从源码编译。(建议使用 Hugo Extended 以获得额外功能的支持。) 安装完成后,在终端内运行以下命令以验证是否安装成功 : hugo version # 输出示例:hugo v0.147.8-10da2bd765d227761641f94d713d094e88b920ae+extended linux/amd64 BuildDate=2025-06-07T12:59:52Z VendorInfo=gohugoio 主题选择 Hugo 官网的 主题页面 提供了许多不同用途的主题以供选择。 笔者选择了 PaperMod 主题,因其简洁现代的设计风格和良好的功能支持。 Hugo 新建站点 使用以下命令创建一个站点: hugo new site test.io # 创建新站点 cd test.io/ git init # 创建 git 仓库,方便主题安装和后期管理 git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod # 使用 git submodule 添加主题 echo "theme = 'PaperMod'" >> hugo.toml # 在配置文件中指定使用 PaperMod 主题 hugo server # 启动 Hugo 本地服务器 你会在终端中看到本地站点的 URL(通常为 http://localhost:1313)。通过浏览器访问即可看见 PaperMod 的默认页面效果: ...