跳过正文
  1. 文章/

Hugo 快速入门指南

·576 字·2 分钟·
博主
作者
博主
用 Hugo 与 Blowfish 构建的中英双语博客。
目录

Hugo 是目前最流行的开源静态站点生成器之一,以构建速度快部署简单著称。本文带你从零开始,搭建并发布你的第一个 Hugo 站点。

安装 Hugo
#

Hugo 的安装方式取决于你的操作系统:

  • macOSbrew install hugo
  • Ubuntu / Debiansudo 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 生态成熟、社区活跃,无论个人博客还是文档站点,它都是一个值得信赖的选择。现在就动手试试吧!