使用 Hexo 搭建个人博客的完整指南

· 5 分钟阅读 · Valen
Hexo 教程

Hexo 是一款基于 Node.js 的静态博客框架，凭借极快的生成速度和丰富的主题生态，成为众多开发者搭建个人博客的首选。它将 Markdown 文件编译为静态 HTML，既轻量又安全，配合 GitHub Pages 即可实现零成本托管。本文将从安装配置到部署上线，带你完整走一遍 Hexo 博客的搭建流程。

为什么选择 Hexo

在众多静态站点生成器（Hugo、Jekyll、VuePress）中，Hexo 依然有它独特的优势：

  • 生成速度快：几百篇文章仅需数秒即可完成编译
  • 主题生态丰富：官方主题市场收录了数百款风格各异的主题
  • 插件系统完善：支持代码高亮、搜索、RSS、SEO 优化等扩展
  • GitHub Pages 零成本托管：无需服务器，一次配置即可永久运行

安装与配置

开始之前，请确保本机已安装 Node.js（建议 LTS 版本）和 Git。然后全局安装 Hexo 命令行工具：

1
2
3
4
npm install -g hexo-cli
hexo init my-blog
cd my-blog
npm install

初始化完成后，目录结构如下：

1
2
3
4
5
6
7
8
my-blog/
├── _config.yml        # 站点配置文件
├── package.json
├── scaffolds/         # 模板文件
├── source/
│   ├── _posts/        # 文章目录
│   └── _drafts/       # 草稿目录
└── themes/            # 主题目录

提示：推荐使用 VS Code 配合 Markdown All in One 插件进行写作，可获得实时预览、快捷键加粗、自动补全等便利。在 scaffolds/ 中自定义模板，可以让 hexo new 生成的文章自带预设的 Front-matter。

主题定制

Hexo 主题基于 EJS 模板引擎渲染，样式则使用 Stylus 或 Sass 预处理器编写。你可以在 themes/ 目录下克隆或修改主题：

1
git clone https://github.com/theme-author/hexo-theme-valencheng themes/valencheng

修改主题时，重点关注 layout/ 下的 EJS 模板与 source/css/ 下的样式文件。定制颜色、字体、布局通常只需调整这几个变量文件。

常用配置项

在站点 _config.yml 中，以下三项最为关键：

  • permalink：控制文章 URL 格式，如 :year/:month/:day/:title/ 或更简洁的 :title/
  • theme：指定当前使用的主题名称，需与 themes/ 下的目录名一致
  • deploy：部署插件配置，决定博客推送到哪里

部署到 GitHub Pages

首先安装部署插件：

1
npm install hexo-deployer-git --save

然后在 _config.yml 中配置 deploy 字段：

1
2
3
4
deploy:
  type: git
  repo: https://github.com/yourname/yourname.github.io.git
  branch: main

执行 hexo clean && hexo g && hexo d 即可一键生成并部署。稍等片刻，访问 https://yourname.github.io 就能看到你的博客上线了。

总结

Hexo 的上手门槛低，但扩展性很强。从安装、目录结构、主题定制到 GitHub Pages 部署，整套流程不到半小时即可跑通。掌握之后，你可以进一步探索插件开发、多语言支持、CI/CD 自动部署等进阶玩法，让博客真正成为你的个人技术名片。