从零开始用 Hugo 搭建个人博客完整指南

2026-08-13

为什么选择 Hugo？

Hugo 是目前最快的静态网站生成器之一，基于 Go 语言开发。相比于 Hexo、WordPress 等方案，Hugo 有以下优势：

⚡ 构建速度极快：几百篇文章毫秒级构建
📦 单二进制部署：不需要 Node.js/PHP 运行环境
🚀 性能卓越：纯静态文件，Nginx 直接托管
🔒 安全性高：没有数据库，没有注入漏洞
💰 成本低廉：可以部署在 GitHub Pages、Vercel 等免费平台

环境准备

安装 Hugo

1
2
3
4
5
6
# Debian/Ubuntu
sudo apt-get install hugo

# 或者下载最新版（推荐 extended 版本，支持 SCSS）
wget https://github.com/gohugoio/hugo/releases/download/v0.165.0/hugo_extended_0.165.0_linux-amd64.deb
sudo dpkg -i hugo_extended_0.165.0_linux-amd64.deb

验证安装：

1
2
hugo version
# 输出类似：hugo v0.165.0+extended linux/amd64

💡 务必安装 extended 版本，很多主题需要 SCSS/Sass 支持。

创建站点

1
2
3
4
5
6
# 创建新站点
hugo new site my-blog
cd my-blog

# 初始化 Git
git init

目录结构

my-blog/
├── archetypes/    # 文章模板
├── assets/        # 资源文件（CSS/JS）
├── content/       # 内容（文章、页面）
├── data/          # 数据文件
├── layouts/       # 自定义模板
├── static/        # 静态文件（直接复制到输出）
├── themes/        # 主题
└── hugo.toml      # 配置文件

选择主题

Hugo 生态有大量优秀主题，推荐几个热门的：

主题	风格	特点
PaperMod	极简博客	轻量快速，功能完善
Reimu	二次元风	博丽灵梦主题，特效丰富
Stack	现代卡片	侧边栏设计，颜值高
Blowfish	Tailwind 风	清新现代，可定制高
Congo	简洁明亮	Tailwind CSS，多色主题

安装主题（以 Reimu 为例）：

1
git submodule add https://github.com/D-Sketon/hugo-theme-reimu.git themes/reimu

修改 hugo.toml：

1
2
3
theme = "reimu"
title = "我的博客"
baseURL = "https://yourdomain.com/"

写文章

1
2
# 创建新文章
hugo new post/my-first-post.md

文章使用 Markdown 格式，front matter 支持 YAML/TOML/JSON：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
---
title: "文章标题"
date: 2026-08-13T14:00:00+08:00
draft: false
categories: ["分类名"]
tags: ["标签1", "标签2"]
description: "文章摘要"
---

## 正文

这里是文章内容...

本地预览

1
2
3
4
5
# 启动开发服务器
hugo server -D

# 浏览器访问
# http://localhost:1313

-D 参数表示包含草稿文章。

构建部署

1
2
3
4
5
# 生产构建
hugo --minify

# 产物在 public/ 目录
# 上传到你的服务器或静态托管平台

使用 Nginx 部署

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
server {
    listen 443 ssl http2;
    server_name yourdomain.com;

    root /path/to/public;
    index index.html;

    # 静态资源缓存
    location ~* \.(css|js|png|jpg|svg|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # HTML 不缓存
    location ~* \.html$ {
        add_header Cache-Control "no-cache";
    }
}

优化建议

图片优化：使用 WebP 格式，配合 lazyload
Gzip 压缩：Nginx 开启 gzip_static
CDN：静态资源上 CDN 加速
HTTPS：Let’s Encrypt 免费证书
SEO：配置 sitemap、robots.txt、结构化数据

总结

Hugo 是个人博客的绝佳选择，构建快、部署简单、性能好。配合 Nginx 或 CDN，可以轻松扛住大量访问。花半小时搭好，之后只需要专注写内容就好。

博客的核心是内容，工具只是载体。选一个喜欢的主题，开始写吧 ✍️