如何使用 Hexo 和 GitHub Pages 搭建免费个人博客

这篇教程将带你一步步使用 Hexo 博客框架和 GitHub Pages 服务，从零开始搭建一个完全免费、功能强大且高度可定制的个人博客网站。

核心优势

免费: 你不需要购买服务器或域名（当然也可以绑定自己的域名）。
快速: Hexo 是一个静态网站生成器，生成的网站访问速度极快。
强大: 拥有丰富的主题和插件生态，轻松实现功能扩展。
掌控数据: 所有文章都是 Markdown 文件，你可以完全掌控自己的数据。

步骤一：环境准备

在开始之前，请确保你的电脑上已经安装了以下软件：

Node.js: Hexo 基于 Node.js 运行。请从 Node.js 官网下载并安装（推荐选择 LTS 版本）。
Git: 用于版本控制和将博客部署到 GitHub。请从 Git 官网下载并安装。
一个 GitHub 账号: 用于托管我们的博客网站。

安装完成后，可以打开终端（命令行工具）通过以下命令检查是否安装成功：

1
2
3

node -v
npm -v
git --version

步骤二：安装 Hexo

环境准备好后，使用 npm 全局安装 Hexo 命令行工具。

1	npm install -g hexo-cli

步骤三：初始化你的博客

选择一个你喜欢的文件夹，在该位置打开终端，然后执行以下命令来初始化一个 Hexo 项目。my-blog 是你博客项目的文件夹名，可以自定义。
1
hexo init my-blog
进入项目文件夹。
1
cd my-blog
安装项目所需的依赖。
1
npm install

初始化完成后，你的项目文件夹结构大致如下：

.
├── _config.yml       # 网站的核心配置文件
├── package.json
├── scaffolds         # 文章模板
├── source            # 存放你的文章、页面、图片等资源
|   ├── _drafts
|   └── _posts
└── themes            # 存放主题

步骤四：本地预览

现在，你的博客已经可以在本地运行了。执行以下命令：

1	hexo server

或者简写为：

hexo s

终端会显示：

1 2	INFO Start processing INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

现在打开浏览器，访问 http://localhost:4000，你就可以看到 Hexo 生成的默认博客页面了。

步骤五：创建第一篇文章

执行以下命令来创建一篇新文章。My-First-Post 是文章的文件名。
1
hexo new "My-First-Post"
你会在 source/_posts 目录下找到一个名为 My-First-Post.md 的文件。
使用任何文本编辑器打开这个文件，你会看到如下内容：
1
2
3
4
5
---
title: My-First-Post
date: 2024-07-10 10:00:00
tags:
---
这部分叫做 Front-matter，用于定义文章的元数据。你可以在下方使用标准的 Markdown 语法开始撰写你的正文内容。
写完保存后，可以重新执行 hexo server，在本地预览你的新文章。

步骤六：部署到 GitHub Pages

这是最关键的一步，让你的博客可以被全世界访问。

1. 创建 GitHub 仓库

登录你的 GitHub 账号。
创建一个新的仓库（New Repository）。
重要: 仓库的名称必须遵循一个特殊的格式：<Your-GitHub-Username>.github.io。例如，如果你的 GitHub 用户名是 octocat，那么你的仓库名就必须是 octocat.github.io。
确保仓库是 公开（Public） 的。

2. 安装部署插件

在你的博客项目文件夹 (my-blog) 中，安装用于 Git 部署的插件。

1	npm install hexo-deployer-git --save

3. 配置部署信息

打开项目根目录下的 _config.yml 文件，找到 deploy 部分（通常在文件末尾），修改为如下配置：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: https://github.com/<Your-GitHub-Username>/<Your-GitHub-Username>.github.io.git # 把这里的用户名换成你自己的
  branch: main # 或者 master，取决于你的 GitHub 默认分支名

提示: repo 的地址请直接从你刚刚创建的 GitHub 仓库页面复制（HTTPS 或 SSH 地址均可）。

4. 执行部署

一切就绪！在终端执行以下命令，将你的博客部署到 GitHub。

1	hexo deploy

或者简写为：

hexo d

部署过程可能需要你输入 GitHub 的用户名和密码（或 Token）。部署成功后，等待几分钟，然后访问你的专属网址 https://<Your-GitHub-Username>.github.io，就可以看到你线上博客了！

步骤七：更换主题（可选）

Hexo 默认的主题比较简单，你可以根据喜好更换成更美观的主题。

访问 Hexo 官网主题页挑选你喜欢的主题。
假设我们选择了一款非常流行的主题 NexT。首先，将主题克隆到 themes 文件夹下。
1
git clone https://github.com/next-theme/hexo-theme-next themes/next
然后，再次打开根目录的 _config.yml 文件，找到 theme 字段，将其值从 landscape 修改为 next。
1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next
保存后，重新执行 hexo clean && hexo g && hexo s 在本地预览新主题的效果。如果满意，再执行 hexo d 部署到线上。