Hugo 是一个能让你快速摆脱束缚的工具 —— 一旦你理解了它的运作方式。下面是我所知道的最短路径:从空目录到一个能用的静态站点。
安装
在 macOS 上使用 Homebrew:
brew install hugo
hugo version
如果你已经有 Go 工具链,go install github.com/gohugoio/hugo@latest 也可以。无论哪种方式,你都应该看到以 hugo v 开头的版本字符串。
搭建
选择一个空目录,让 Hugo 生成布局:
mkdir my-site && cd my-site
hugo new site . --force
当目录不是完全空时,需要 --force 参数。生成结果是一棵小型的目录树,包含 archetypes、content、layouts、themes,以及一个 hugo.toml 配置文件。
添加主题
你可以编写自己的主题 —— 对于个人博客,我建议这样做。Hugo 主题本质上就是 themes/ 下的一个目录,内含 theme.toml 和 layouts/ 树。最小的主题需要:
theme.toml—— 名称和元数据layouts/_default/baseof.html—— 基础模板layouts/index.html—— 首页layouts/_default/single.html—— 单篇文章layouts/_default/list.html—— 文章列表
然后在 hugo.toml 中指向它:
theme = "your-theme-name"
撰写内容
每篇文章都是一个带有 front matter 的 markdown 文件:
+++
date = 2026-09-01
title = "我的第一篇文章"
summary = "用于文章卡片的简短描述。"
tags = ["随笔"]
+++
正文内容在这里。标准 markdown。
构建
hugo # 将静态文件输出到 public/
hugo server # 带热重载的本地开发服务器
这就是整个流程。从这里开始,每一个决定都是迭代,而不是架构选择。