Hexo 博客使用指南：从入门到精通

2024/1/16 使用指南 Hexo 博客管理教程

欢迎使用您的个人博客！这份指南将帮助您快速掌握博客的各项功能，让您能够专注于内容创作，轻松管理您的博客。

快速开始

日常写作流程

创建新文章
```
hexo new "文章标题"
```
编辑文章
- 文章会创建在 source/_posts/ 目录下
- 使用 Markdown 语法编写内容
- 记得填写文章的 Front Matter（文章头部信息）
本地预览
```
hexo clean
hexo generate
hexo server
```
然后访问 http://localhost:4000 查看效果
发布文章
```
hexo deploy
```

文章管理

Front Matter 详解

每篇文章开头的配置信息非常重要：

---
title: 文章标题              # 必填
date: 2024-01-16 08:00:00   # 发布日期
updated: 2024-01-16 08:00:00 # 更新日期
categories:                  # 分类（可多个）
  - 技术分享
  - 前端开发
tags:                       # 标签（可多个）
  - JavaScript
  - Vue.js
description: 文章描述        # SEO 描述
cover: 图片URL              # 封面图
comments: true              # 是否开启评论
toc: true                   # 是否显示目录
toc_number: true            # 目录是否显示编号
top: false                  # 是否置顶
mathjax: false              # 是否启用数学公式
---

分类和标签

合理的分类建议：

技术分享
学习笔记
生活随笔
项目总结
读书笔记
工具推荐

标签使用技巧：

使用具体的技术名称作为标签
避免标签过于宽泛
保持标签的一致性

文章摘要

使用  标记来分隔摘要和正文：

这里是文章摘要，会在首页显示。
<!-- more -->
这里是正文内容，需要点击"阅读更多"才能看到。

Markdown 进阶技巧

1. 代码块

支持语法高亮的代码块：

```javascript
function hello() {
    console.log('Hello, World!');
}
```

2. 任务列表

- [x] 已完成的任务
- [ ] 待完成的任务
- [ ] 另一个待完成的任务

效果：

已完成的任务
待完成的任务
另一个待完成的任务

3. 表格

| 命令 | 描述 | 使用频率 |
|------|------|---------|
| hexo new | 创建新文章 | ⭐⭐⭐⭐⭐ |
| hexo server | 本地预览 | ⭐⭐⭐⭐⭐ |
| hexo deploy | 部署发布 | ⭐⭐⭐⭐ |

4. 引用

> 这是一段引用文字
> 可以有多行

5. 提示框（需要主题支持）

{% note info %}
这是一个信息提示框
{% endnote %}

{% note warning %}
这是一个警告提示框
{% endnote %}

图片管理

方式一：使用图床

推荐使用免费图床服务：

Unsplash - 高质量免费图片
SM.MS - 免费图床
ImgURL - 免费图床

方式二：本地图片

开启文章资源文件夹：
```
# _config.yml
post_asset_folder: true
```

在文章中引用：

{% asset_img example.jpg 图片描述 %}

常用命令速查

基础命令

# 创建新文章
hexo new "文章标题"

# 创建新页面
hexo new page "页面名称"

# 创建草稿
hexo new draft "草稿标题"

# 发布草稿
hexo publish draft "草稿标题"

服务器命令

# 清理缓存
hexo clean

# 生成静态文件
hexo generate
# 简写
hexo g

# 启动本地服务器
hexo server
# 简写
hexo s

# 部署到远程
hexo deploy
# 简写
hexo d

组合命令

# 清理 + 生成
hexo clean; hexo g

# 生成 + 部署
hexo g -d

# 启动服务器并监听文件变化
hexo s --draft

插件推荐

1. 搜索功能

安装本地搜索插件：

npm install hexo-generator-searchdb --save

2. RSS 订阅

npm install hexo-generator-feed --save

3. 站点地图

npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save

4. 字数统计

npm install hexo-wordcount --save

主题定制

修改主题配置

主题配置文件位置：themes/particlex/_config.yml

常见配置项：

导航菜单
侧边栏内容
社交链接
评论系统
统计代码

自定义样式

如需修改样式，可以在主题的 source/css/ 目录下添加自定义 CSS 文件。

备份策略

1. Git 版本控制

将博客源码托管到 GitHub：

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/username/blog-source.git
git push -u origin main

2. 重要文件

需要备份的文件：

source/ - 所有文章和页面
_config.yml - 站点配置
themes/ - 主题文件
package.json - 依赖列表

常见问题

Q1: 如何修改文章的永久链接格式？

编辑 _config.yml：

permalink: :year/:month/:day/:title/
# 或者
permalink: posts/:title/

Q2: 如何添加友情链接？

创建友链页面：

hexo new page links

然后编辑 source/links/index.md。

Q3: 如何开启评论功能？

在主题配置文件中配置评论系统（如 Gitalk、Valine 等）。

Q4: 部署失败怎么办？

检查 _config.yml 中的 deploy 配置
确认 Git 权限设置正确
尝试 hexo clean 后重新部署

进阶技巧

1. 使用 GitHub Actions 自动部署

创建 .github/workflows/deploy.yml 实现自动部署。

2. 多设备同步

使用 Git 分支管理源文件，实现多设备协作。

3. 性能优化

启用图片懒加载
压缩静态资源
使用 CDN 加速

写作建议

保持更新频率：建议每周至少更新一篇
注重内容质量：宁缺毋滥，质量优于数量
互动交流：积极回复读者评论
持续学习：不断改进写作技巧

结语

博客是记录成长、分享知识的最佳平台。希望这份指南能帮助您更好地使用博客系统。如有任何问题，欢迎查阅 Hexo 官方文档或在评论区留言。

祝您写作愉快！🎉

小贴士：建议将这篇指南置顶或加入书签，方便随时查阅。记得定期查看是否有更新哦！

LOADING