从零开始：手把手教你用 GitHub 免费部署 Hugo 博客

Tue, 03 Mar 2026 12:00:00 +0800

嘿！想拥有一个既极速又极简，还完全免费的个人博客吗？

很多小伙伴被“部署”、“服务器”、“域名”这些词吓到了。其实，利用 Hugo（世界上最快的静态网站生成器） 和 GitHub（全球最大的代码托管平台），你只需要动动手指，就能拥有一个专属的互联网小家。

今天这篇教程，就是专门为“小白”准备的避坑指南。

一、为什么选择 Hugo + GitHub？

快： Hugo 生成页面的速度是以“毫秒”计算的。
省： GitHub Pages 提供的托管服务完全免费，连服务器钱都省了。
稳：只要 GitHub 不倒闭，你的博客就永远在线。
酷：纯文本写作，像程序员一样记录生活。

二、准备工作（你需要准备什么）

在开始之前，请确保你已经：

注册了一个 GitHub 账号。
在电脑上安装了 Git 和 Hugo（如果还没装，可以去官网下载，一路“下一步”即可）。

三、实战步骤

1. 本地创建博客

打开终端（Windows 的 PowerShell 或 Mac 的 Terminal），输入：

hugo new site my-blog
cd my-blog

2. 挑选一个“皮肤”（主题）

没有皮肤的博客是不完整的。我们以经典的 PaperMod 为例：

git init
git submodule add --depth=1 [https://github.com/adityatelange/hugo-PaperMod.git](https://github.com/adityatelange/hugo-PaperMod.git) themes/PaperMod
echo "theme = 'PaperMod'" >> hugo.toml

3. 写下第一篇文章

hugo new posts/hello-world.md

打开生成的 content/posts/hello-world.md，随便写点什么。

4. 推送到 GitHub

这是最关键的一步。

在 GitHub 上新建一个仓库，名字叫：你的用户名.github.io（例如 zhangsan.github.io）。
在本地博客根目录，关联这个仓库并推送：

git commit -m "初次建站"
git branch -M main
git remote add origin [https://github.com/你的用户名/你的用户名.github.io.git](https://github.com/你的用户名/你的用户名.github.io.git)
git push -u origin main

5.开启自动化部署（GitHub Actions）

现在最流行的做法是使用 GitHub Actions。你只需要在 GitHub 仓库的设置（Settings -> Pages）里，把 Build and deployment 的源改为 GitHub Actions。

GitHub 会自动识别 Hugo 项目并帮你把网页“变”出来。几分钟后，访问 https://你的用户名.github.io，奇迹就发生了！

四、掌握写作利器：Markdown (MD)

既然用了 Hugo，你就必须学会用 Markdown 写作。这是一种“所见即所得”的轻量级标记语言。

为什么大家都爱 Markdown？专注于文字：你不需要纠结字体大小、行间距，写完即排版。

跨平台：任何编辑器都能打开，不会像 Word 文档那样格式错乱。

代码友好：插入代码块非常漂亮，适合技术人。

常用命令“小抄” 如果你是第一次使用，记住下面这几个就够用了：

效果	Markdown 语法
一级标题	`# 标题名字`
二级标题	`## 标题名字`
加粗	`这是粗体`
斜体	`这是斜体`
超链接	`[文字](链接地址)`
插入图片	`![描述](图片地址)`
无序列表	`* 列表项`
引用代码	`代码内容`

温馨提示： 在 Markdown 中，所有的符号（如 #、*、!）后面都要加一个空格，这样格式才最标准。

五、结语

搭建博客只是第一步，持续的输出才是灵魂。

利用 Hugo，你可以摆脱社交平台的束缚，拥有一个完全属于自己的思考空间。

GitHub on 小小时候的胡同

从零开始：手把手教你用 GitHub 免费部署 Hugo 博客

一、 为什么选择 Hugo + GitHub？

二、 准备工作（你需要准备什么）

三、 实战步骤