Hugo 是目前最流行的开源静态站点生成器之一,以构建速度快和部署简单著称。本文带你从零开始,搭建并发布你的第一个 Hugo 站点。
安装 Hugo#
Hugo 的安装方式取决于你的操作系统:
- macOS:
brew install hugo - Ubuntu / Debian:
sudo apt install hugo - Windows:使用 Chocolatey 或 Scoop:
choco install hugo - 其他平台:前往 Hugo Releases 下载对应二进制
安装完成后,验证版本:
hugo version创建新站点#
使用 hugo new site 命令快速初始化一个站点骨架:
hugo new site quickstart
cd quickstart这会生成 content/、layouts/、static/ 等标准目录结构。
添加主题#
Hugo 站点需要主题才能渲染页面。以 Hextra 为例:
git init
git submodule add https://github.com/imfing/hextra.git themes/hextra然后在 hugo.toml 中声明主题:
theme = 'hextra'编写第一篇文章#
用 hugo new 创建文章,front matter 使用 TOML 格式:
hugo new posts/my-first-post.md文章头部包含日期、标题等元数据,正文使用 Markdown 书写,支持代码块、表格、图片等丰富语法:
+++
date = '2026-08-14T17:55:41+08:00'
draft = false
title = 'My First Post'
+++
## 简介
这是 **粗体** 文本,这是 *斜体* 文本。本地预览#
启动开发服务器,Hugo 会在文件变更时自动刷新页面:
hugo server -D浏览器访问 http://localhost:1313 即可实时预览。
构建与部署#
正式发布前,先生成静态文件:
hugo构建产物默认输出到 public/ 目录,直接将其托管到 GitHub Pages、Netlify 或 Vercel 即可上线。
小结#
| 步骤 | 命令 |
|---|---|
| 创建站点 | hugo new site quickstart |
| 添加主题 | git submodule add <theme-url> |
| 新建文章 | hugo new posts/xxx.md |
| 本地预览 | hugo server -D |
| 构建发布 | hugo |
Hugo 生态成熟、社区活跃,无论个人博客还是文档站点,它都是一个值得信赖的选择。现在就动手试试吧!

