hexo博客进阶

前言

前几天我发布了一个有关hexo的文章，这次是进阶。
本次将教你如何使用主题、写文章和构建。

主题

找主题的话，你可以去百度一下，本次仅仅教学如何使用主题。
安装主题我以butterfly为一个🌰
进入博客根目录（就是博客的主文件夹啦）用git把butterfly clone到themes文件夹里面
如果你使用的是Windows系统，你可以点击资源管理器上方地址栏输入cmd快捷打开。
先cd进themes文件夹，然后输入以下命令：

git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

坐和放宽，等着clone完成即可
接下来就是依赖了，注意这个只有部分主题有，butterfly是需要装的。
同样，用刚才的方式打开（如果窗口未关闭就用已打开的）输入下面的命令：

npm install hexo-renderer-pug hexo-renderer-stylus --save

主题就已经安装好了，但没有在hexo启用，我们需要到hexo的配置文件去配置主题。
返回到博客根目录，打开_config.yml修改theme字段，以下是示例：

theme: butterfly

此时主题就算是成功启用了，此时构建就可以看到你的博客焕然一新，但是大部分主题都可以配置的，所以为了美观我们就去配置罢。
复制themes/butterfly/_config.yml到根目录，重命名为_config.butterfly.yml（后续修改这个文件，避免主题更新覆盖配置）可在里面改颜色、导航栏、侧边栏等（详情参考butterfly文档）

写文章

hexo是用md格式来加载你的文章的，所以你写的东西也要遵循md格式。
在刚才的cmd窗口，输入hexo new "文章标题"提示完成后打开source/_posts/文章标题.md顶部会有一段「Front-matter」（就是---啦），这是文章的信息配置，示例：

---
title: 从今天开始我要自己搭建博客，爸爸妈妈再也不用担心我不会搭建博客力  # 文章标题（必填）
date: 2025-10-17 15:30:00  # 发布时间（自动生成，可修改）
tags: [Hexo, 博客技巧]  # 标签（数组形式，多个标签用逗号分隔）
categories: 114514  # 分类（单个或多个，如「技术教程>Hexo」）
cover: /images/hexo-write.jpg  # 文章封面图（可选，路径在source/images下）
draft: false  # 是否草稿（true=草稿，不生成；false=发布）
---

md你可以使用市面上的一些工具，这里我就不做推荐了。

构建

我介绍几个常用的命令，首先是hexo clean简单概述就是清理缓存，推荐在修改主题的时候使用；然后是hexo generate简单命令就是hexo g这个就是构建了，构建完成会在public文件夹内；最后就是hexo g -d这种就是生成和自动部署，就是写完文章自动构建。
下面是常见问题：
本地预览看不到新文章
检查：由于是静态网页，需要浏览器刷新缓存，或者采用下面方式：文章draft是否设为false；检查是否执行hexo g
构建后样式错乱
解决：执行hexo clean清除缓存，再重新hexo g（缓存文件可能导致样式不更新）。​
图片404？
确认图片路径：本地预览用/images/xxx.jpg（根路径），部署后若用 GitHub Pages，需先在根配置_config.yml中设置url: https://你的用户名.github.io。

后言

下次就会教你如何托管到Github Pages以及类似的平台上。