从零开始：基于 Hexo 与 GitHub Pages 搭建个人博客

本文是关于如何使用 Hexo 框架结合 GitHub Pages 零成本搭建个人静态博客的完整流程记录，适合所有希望拥有一片属于自己的互联网精神自留地的开发者。

1. 为什么选择 Hexo？

对于写代码的人来说，相较于沉重臃肿的动态博客系统（如 WordPress），Hexo 是一个基于 Node.js 的超强静态博客框架。
它的核心优势非常明显：

• 速度极快：数百篇文章只需几秒即可渲染成纯 HTML，部署在任何静态托管服务上秒开。
• 支持 Markdown：使用程序员最爱的强力标记语言进行写作。
• 零成本托管：完美支持一键部署到 GitHub Pages 等服务。

2. 环境配置与工具准备

在开始搭建之前，我们需要确保电脑里安装了两个前置核心工具：

1. Node.js：因为 Hexo 是基于 Node 开发的，提供了执行环境。
2. Git：版本控制工具，用于将最终编译的博客项目推送到 GitHub。

安装完成后，可以在终端或控制台输入以下指令验证：

1
2

node -v
git --version

3. 安装与初始化 Hexo

准备好环境后，整个安装过程一气呵成。打开你的命令行，通过 npm 全局安装 hexo-cli：

1

npm install -g hexo-cli

紧接着，在你期望存放博客源码的目录（比如 d:\hexo-blog）下运行初始化命令：

1
2
3

hexo init hexo-blog
cd hexo-blog
npm install

这个时候，你的本地就已经诞生了一个基础的博客文件树了。输入 hexo s (server的缩写)，在浏览器打开 http://localhost:4000 即可预览默认界面！

4. 将博客部署到星辰大海（GitHub Pages）

本地只能自己看，我们需要将它推向互联网。

4.1 创建 GitHub 仓库

在 GitHub 创建一个全新的仓库，仓库名有着严格的规范，必须命名为：你的用户名.github.io （比如 Evanescent521.github.io）。

4.2 配置一键部署

打开博客根目录下的核心配置文件 _config.yml，划到最底部，修改 deploy 字段如下（注意冒号后面有一个空格）：

1
2
3
4

deploy:
  type: git
  repo: git@github.com:Evanescent521/Evanescent521.github.io.git
  branch: main

最后，安装一键部署的插件并执行推流指令：

1
2

npm install hexo-deployer-git --save
hexo clean && hexo g && hexo d

至此，只要等待 1-2 分钟（GitHub 后台的构建时间），全世界就能通过 你的用户名.github.io 访问到你的专属空间了。

5. 个性化：这才是极客该有的样子

默认的 Landscape 主题显然无法满足个人的审美。在这个博客里，我使用了 alpha-dust 主题，并对其进行了修改：

• 动态标签特效：去除了原版冗余的日期与分类标签，改为纯净的大图与悬浮反馈。
• 自定义指针覆盖：抛弃了枯燥的白色箭头，修改 CSS 底层并分别注入了针对普通状态与超链接覆盖的全局特效光标 .cur 文件。
• 联系页面：通过嵌入 Steam 动态头像的 CDN 直链数据，强行绕开了跨域限制，点缀了交互代码。

Per aspera ad astra. (循此苦旅，以达星辰)

建站只是我们漫长技术生涯最初的一小步。准备好一杯咖啡，打开编辑器，开始你的技术之旅吧！