这篇文章记录一下博客搭建的过程,供自己日后回顾,也希望对同样想搭建静态博客的人有所帮助。
技术选型
最终选择了 Hugo + GitHub Pages 的组合:
- Hugo:Go 语言编写,构建速度极快,无需复杂的运行时环境
- GitHub Pages:免费静态托管,与代码仓库无缝集成
- GitHub Actions:自动化 CI/CD,推送代码后自动构建部署
目录结构
blog/
├── content/
│ ├── posts/ # 文章
│ └── about/ # 关于页面
├── layouts/ # 自定义模板
├── static/ # 静态资源
├── hugo.toml # 配置文件
└── .github/
└── workflows/
└── deploy.yml # 自动部署脚本
部署流程
- 本地编写 Markdown 文章
- 推送到
main分支 - GitHub Actions 自动触发,调用 Hugo 构建
- 构建产物推送到
gh-pages分支 - GitHub Pages 自动发布
整个流程几分钟内完成,非常顺畅。
写作工作流
新建文章只需在 content/posts/ 目录下创建 .md 文件,在文件头部写 Front Matter:
---
title: "文章标题"
date: 2026-05-26
tags: ["标签1", "标签2"]
draft: false
---
正文内容...
就这么简单。