← 返回首页

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

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

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

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

一、为什么选择 Hugo + GitHub？

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

二、准备工作

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

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

三、实战步骤

1. 本地创建博客

hugo new site my-blog
cd my-blog

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

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

3. 写下第一篇文章

hugo new posts/hello-world.md

4. 推送到 GitHub

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

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

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

在 GitHub 仓库的设置（Settings -> Pages）里，把 Build and deployment 的源改为 GitHub Actions。

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

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

五、结语

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

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