静态站点

本文是 Hugo + PaperMod 博客搭建：从 0 到评论上线，我踩过的坑 的「完整版」——上篇是叙事版，这篇是参考手册版。读这一篇就能掌握搭建这个博客用到的全部 Hugo 知识。 1. 什么是 Hugo Hugo 是一个用 Go 写的静态站点生成器（Static Site Generator, SSG）。你写 Markdown，Hugo 编译成 HTML，浏览器直接读 HTML 文件。 跟同类对比： 工具 语言 特点 Hugo Go 快——几千页也毫秒级编译 Jekyll Ruby 老牌，GitHub Pages 原生支持 Hexo Node.js 中文社区多 Gatsby React + GraphQL 适合复杂前端 Astro 多框架 现代，新兴 Hugo 的最大卖点是速度——几千篇文章的站，一次完整 build 通常 < 1 秒。本地 hugo server 改一行就热更新，几乎无感。 ℹ️Info > Hugo 是「无依赖」工具——单文件可执行（~30 MB），不装 Node、不装 Ruby、不装数据库。丢任何机器上都能跑。 > 2. 安装 macOS 1 brew install hugo Linux 1 2 3 4 5 # Debian/Ubuntu sudo apt install hugo # 或最新版（推荐） snap install hugo --channel=extended ⚠️Warning > 装 **`extended`** 版本——后面要用 Hugo Pipes 处理 SCSS，普通版不支持。 > Windows 1 2 choco install hugo-extended # 或 scoop install hugo-extended 验证 1 2 hugo version # hugo v0.158.0+extended ... 3. 初始化一个新站 1 2 hugo new site my-blog cd my-blog 生成结构： ...