hexo

Hexo 博客维护手册

Posted by Shane on 2026-01-21

Hexo 博客维护手册

1. 环境检查

如果换了电脑或重装系统，请先执行：

  • 安装依赖：在项目根目录下运行 npm install。
  • 全局工具：确保已安装 npm install -g hexo-cli。

2. 核心命令手册

功能 命令 简写 备注
新建文章 hexo new "标题" hexo n 在 source/_posts 生成 .md 文件
清理缓存 hexo clean 无 遇到页面不更新时必做
生成静态页 hexo generate hexo g 将 Markdown 转为 HTML
启动预览 hexo server hexo s 默认地址：http://localhost:4000
部署发布 hexo deploy hexo d 上传至 GitHub Pages

3. 全流程操作指南 (从新建到发布)

当你想要写一篇新博客时，请遵循以下标准流程：

第一步：创建新文件

在终端输入：

1
2
hexo new "我的新博文"

此时，Hexo 会在 source/_posts/ 目录下创建一个 我的新博文.md 文件。

第二步：撰写内容

使用编辑器打开该 .md 文件，编辑 Front Matter（开头部分）：

1
2
3
4
5
6
7
8
9
10
---
title: 我的新博文
date: 2026-01-21 10:45:00
tags:
  - 技术
  - 教程
categories: 笔记
---
这里是正文...

第三步：本地预览 (关键)

在发布前，先在本地看看效果：

1
2
hexo clean && hexo s

打开浏览器访问 http://localhost:4000。确认无误后，按下 Ctrl + C 停止预览。

第四步：推送到 GitHub

执行一键生成并部署命令：

1
2
hexo g -d

稍等几分钟，你的 GitHub Pages 就会更新内容了。

4. 常见问题备忘

  • 多标签写法：tags: [标签1, 标签2]。
  • 图片存放：建议放在 source/images/，文中引用：![描述](/images/xxx.png)。
  • 配置文件：
  • _config.yml (根目录)：改网站名、改 GitHub 地址。
  • _config.yml (主题目录)：改菜单、改头像、改评论插件。
FEATURED TAGS
hexo
FRIENDS