用 Hugo 搭一个静态博客

记录一下这个博客是怎么搭起来的，万一以后要重装，照着做就行。

为什么选 Hugo

对比了几个方案：

服务器配置不高，WordPress 跑起来有点吃力，最后选了 Hugo。构建完就是一堆静态 HTML，Nginx 直接托管，几乎不占资源。

安装

Windows 上下载 release 里的 hugo_extended_xxx_windows-amd64.zip，解压得到 hugo.exe 就能用。

一定要选 extended 版本，很多主题用了 SCSS，普通版构建会报错。

建站

hugo new site blog
cd blog

然后把主题放到 themes/ 目录下，在 hugo.toml 里写：

baseURL = "https://example.com/"
languageCode = "zh-cn"
title = "我的博客"
theme = "PaperMod"

写文章

hugo new posts/first.md

生成的 Markdown 开头有一段 front matter：

---
title: "文章标题"
date: 2026-10-30
draft: false
tags: ["随笔"]
---

draft 默认是 true，忘了改的话构建出来是空的，这个坑我踩过。

构建与部署

hugo --minify

产物在 public/ 目录，传到服务器：

scp -r public/* root@server:/var/www/blog/

Nginx 配置很简单：

server {
    listen 80;
    server_name example.com;
    root /var/www/blog;
    index index.html;
    location / {
        try_files $uri $uri/ =404;
    }
}

一点感受

静态博客最大的好处是没有数据库、没有后台、没有登录，也就没有漏洞和备份的烦恼。写完 Markdown 构建一下，传上去就完事。

缺点也明显：不在电脑前就没法写。不过对我来说不是问题，本来也不会在手机上写长文。

就这样，博客算是搭起来了。