Hexo 博客日常使用完整教程（部署 / 写作 / 页面管理）
本文用于解决一个非常真实的问题：
👉「Hexo 放了一段时间没用，又忘了该怎么操作」
内容涵盖 部署到 GitHub、写文章、新建页面、日常维护，
建议长期保留在博客中，作为个人 Hexo 使用手册。
一、最重要的事：如何同步到 GitHub（必背）
✅ 一行命令解决 90% 场景
含义：
hexo g：生成静态文件hexo d：部署到 GitHub Pages-g：部署前自动生成
👉 写完博客 = 执行这条命令
二、推荐的完整部署流程（稳妥版）
当页面异常、样式没更新时，使用完整流程：
hexo clean
hexo generate
hexo deploy
|
或简写：
hexo clean && hexo g && hexo d
|
三、本地预览博客（强烈推荐）
在部署前，先本地看看效果：
或：
访问：
四、新建文章（最常用）
1️⃣ 新建一篇文章
例如：
生成文件位置：
source/_posts/Hexo使用教程.md
|
2️⃣ 新建指定类型的文章（如 post）
3️⃣ 文章头部 Front-matter 说明
新文章顶部一般如下：
---
title: Hexo 使用教程
date: 2026-01-29 10:00:00
tags:
- Hexo
- 博客
categories:
- 技术
---
|
title：文章标题date：发布时间tags：标签（可多个）categories：分类（一般一个）
五、新建页面（关于页 / 友链页 等）
1️⃣ 新建一个页面
例如新建「关于我」页面：
生成目录：
2️⃣ 页面和文章的区别
| 类型 |
是否出现在首页 |
用途 |
| 文章（post） |
✅ 是 |
博客内容 |
| 页面（page） |
❌ 否 |
关于 / 友链 / 标签页 |
六、常见功能页面（主题相关）
以下页面通常需要主题支持
1️⃣ 标签页
并在 source/tags/index.md 中添加：
---
title: 标签
type: tags
---
|
2️⃣ 分类页
内容：
---
title: 分类
type: categories
---
|
七、草稿的使用（可选但很实用）
1️⃣ 新建草稿
目录：
2️⃣ 本地预览草稿
3️⃣ 发布草稿
八、Hexo 常用命令速查表（重点收藏）
hexo init
hexo new
hexo new page
hexo new draft
hexo publish
hexo clean
hexo g
hexo s
hexo d
hexo d -g
|
九、部署前必要检查（一次配置，长期受用）
1️⃣ 安装 Git 部署插件
npm install hexo-deployer-git --save
|
2️⃣ _config.yml 示例
deploy:
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git
branch: main
|
十、常见问题备忘（救命清单）
- 页面没更新
→ hexo clean && hexo d -g
hexo d 报错
→ 是否安装 hexo-deployer-git- GitHub Pages 404
→ 仓库名是否为 用户名.github.io
- 样式错乱
→ 清缓存 + 重新生成
十一、一句话总结（写给未来的自己）
Hexo 博客日常流程：
写文章 → 本地预览 → hexo d -g → 完事
|
如果你多年后再看到这篇文章：
恭喜你，已经成功救了自己一次 😄
