约 900 字

3 分钟

Hugo 搭建博客教程：零成本拥有自己的网站

-

摘要

Hugo 是最快的静态网站生成器，配合 GitHub Pages/Cloudflare Pages 零成本建博客。本教程依据 Hugo 官方文档，介绍 extended 版安装、三步建站与主题引入、Front Matter 写作、hugo.toml 配置、构建部署两条路线，以及目录结构速览。

Hugo 搭建博客教程：最快的静态网站生成器

想拥有自己的博客？Hugo 是 Go 写的静态网站生成器，构建速度快到毫秒级，生成的纯静态文件随便扔在哪都能跑——GitHub Pages、Cloudflare Pages 全免费托管。本博客本身也是静态站思路的实践。本教程依据 Hugo 官方文档（gohugo.io）整理。

一、安装

bash

# Windows (scoop)
scoop install hugo-extended

# macOS
brew install hugo

# Debian/Ubuntu（建议下载官方 deb 包以获得最新版）
hugo version

注意装 hugo-extended 版本——很多主题依赖其扩展功能（Sass 编译）。

二、三步建站

bash

hugo new site myblog       # 创建站点骨架
cd myblog
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo server -D             # 本地预览，http://localhost:1313

-D 表示包含草稿。改文章、改配置都是保存即热更新。

三、写文章

bash

hugo new posts/first-post.md

生成的 Markdown 文件头部是 Front Matter（元数据）：

markdown

---
title: "我的第一篇文章"
date: 2026-08-30
draft: false
tags: ["生活"]
---

正文就是标准 Markdown。

文件保存在 content/posts/ 下。

四、配置文件

站点根目录的 hugo.toml（或 config.toml）控制全局：

toml

baseURL = 'https://你的域名/'
title = '我的博客'
theme = 'ananke'

[params]
  description = '记录技术与生活'

换主题就是改 theme 一行——主题列表见官网 themes 页，PaperMod 是目前最流行的博客主题之一。

五、构建与部署

bash

hugo                        # 构建到 public/ 目录

public/ 里的纯静态文件就是整个网站。部署方案：

方案 A：GitHub Pages（官方推荐流程）

推送到 GitHub，仓库设置里把 Source 指向 GitHub Actions
用官方文档提供的 hugo.yml workflow（hugo 官方文档有现成模板）
每次 push 自动构建并发布，访问 用户名.github.io

方案 B：Cloudflare Pages（国内访问较友好）

Cloudflare Pages 连接 GitHub 仓库
构建命令填 hugo，输出目录 public
之后 push 自动部署，还送 CDN 和 HTTPS

六、目录结构速览

纯文本

myblog/
├── content/        # 文章（Markdown）
├── themes/         # 主题
├── static/         # 图片等静态资源
├── hugo.toml       # 站点配置
└── public/         # 构建产物（gitignore）

七、总结

需求	命令
建站	`hugo new site 名字`
本地预览	`hugo server -D`
写文章	`hugo new posts/xxx.md`
构建	`hugo`，产物在 `public/`
托管	GitHub Pages / Cloudflare Pages

Hugo + Markdown + Git 托管，就是零成本博客的完全体：写作体验轻快，加载飞快，永不宕机。

END

Hugo 搭建博客教程：零成本拥有自己的网站

摘要

Hugo 搭建博客教程：最快的静态网站生成器

一、安装

二、三步建站

三、写文章

四、配置文件

五、构建与部署

六、目录结构速览

七、总结

相关文章

tar 打包与压缩教程：xz/gz 一条命令搞定

fnm 使用教程：秒切 Node.js 版本

Linux 文件权限教程：chmod 与 chown 一次搞懂

crontab 定时任务教程：让命令到点自动执行