Hexo博客新手操作速查手册

本手册涵盖了 Hexo 博客从创建、写作、部署、备份到版本更新的全流程操作，旨在成为你日常管理的“瑞士军刀”。

---

一、文章与页面管理

1. 新建文章

在 source/_posts 目录下创建新文章。

hexo new "我的新文章标题"

• 别名: hexo n "文章标题"
• 建议: 标题尽量使用英文 (my-new-post)，避免中文文件名可能带来的问题。

2. 新建独立页面

用于创建“关于”、“友链”等独立页面。

hexo new page "about"

• 这会在 source 目录下创建一个 about 文件夹及 index.md 文件。
• 编辑 source/about/index.md 来填充页面内容。
• 记得在主题配置的 menu 中添加入口链接。

3. 更新与删除文章

• 更新: 直接用编辑器打开 source/_posts 下的 .md 文件修改并保存即可。
• 删除: 直接在 source/_posts 目录下删除对应的 .md 文件即可。

4. 分类与标签设置

在文章 .md 文件顶部的 Front-matter 区域进行设置。

• 单个分类/标签:

  ---
  title: Hexo入门指南
  tags: Hexo
  categories: 技术
  ---

• 多个标签 (推荐列表格式):

  ---
  title: Vercel部署教程
  tags:
    - Hexo
    - Vercel
    - 部署
  categories: 技术教程
  ---

• 多级分类 (层级分类):

  ---
  title: 深入理解CSS
  categories:
    - 技术教程
    - 前端开发
    - CSS
  ---

  注意: 多数主题只支持一个顶级分类，即使设置多个，也可能只显示第一个。

---

二、版本管理与更新 (新增)

保持核心和主题的更新至关重要。

1. Hexo 核心版本管理

• 查询当前版本:

  hexo version
  # 或者简写
  hexo v

  这会列出 hexo-cli、hexo 以及其他核心组件的版本。

• 查询最新版本:

  npm view hexo version

• 更新 Hexo: 分为两步，更新命令行工具和更新本地项目依赖。

  # 1. 更新全局命令行工具
  npm install hexo-cli -g
  
  # 2. 更新项目内的 Hexo 版本
  npm install hexo --save

2. Hexo 主题版本管理

主题的更新方式取决于当初的安装方式。最常见的是通过 Git 安装。

• 查询当前版本:

  1. 进入主题目录: cd themes/你的主题名 (例如 cd themes/butterfly)
  2. 查看最新的 commit 记录: git log -1

     这会显示你本地主题的最新一次提交记录，可以此判断版本。

• 查询最新版本:
  直接访问你所用主题的 **GitHub 发布页面 (Releases Page)**。这是查看官方最新版本号和更新日志的最准确方式。

  • 例如 Butterfly 主题的发布页: https://github.com/jerryc127/hexo-theme-butterfly/releases

• 更新主题 (Git 方式):
  警告: 直接更新会覆盖你对主题的自定义修改！请务必先备份！

  1. （重要）备份你的修改:

     • 进入主题目录: cd themes/你的主题名
     • 暂存你的修改: git stash (这会将你的修改临时保存起来)

  2. 拉取最新代码:

     git pull

  3. （可选）恢复你的修改:

     git stash pop

     此时，Git 会尝试将你之前的修改应用到新的主题代码上。**很可能会发生冲突 (conflict)**，需要你根据提示手动解决冲突文件。对于不熟悉 Git 的用户，更稳妥的方式是：更新后，参考之前的备份，将必要的修改重新手动配置一遍。

---

三、本地预览与部署

1. 本地预览

hexo server
# 简写: hexo s

• 启动后，访问 http://localhost:4000 查看效果。

2. 上传到阿里云 OSS (手动部署)

# 完整命令
hexo clean && hexo generate && hexo deploy

# 简写命令 (更常用)
hexo clean && hexo d -g

3. 上传到 Vercel (自动部署)

部署到 Vercel 后，你不再需要运行 deploy 命令。你的工作流是：

1. 本地修改文章或配置。
2. 将源码推送到 GitHub:

   git add .
   git commit -m "更新了一篇文章"
   git push

3. 完成！ Vercel 会自动完成后续所有部署工作。

4. 一键推送（同时部署到Vercel + 备份源码）

# 将所有修改都“放进箱子”
git add .

# “封箱贴条”，在引号里写清楚这次您主要做了什么
git commit -m "更新了一篇文章"

git push origin main

---

四、备份

使用 Git 和 GitHub 备份你的博客源码。

# 1. 添加所有变动
git add .
# 2. 创建提交记录
git commit -m "这里写本次备份的内容"
# 3. 推送到远程 GitHub 仓库
git push

养成每次修改完都 push 一次的好习惯，就等于拥有了最完美的实时备份。

---

五、常用命令汇总表

功能分类	命令	简写	描述
写作	hexo new "文章标题"	hexo n "文章标题"	新建一篇文章
	hexo new page "页面名"	hexo n page "页面名"	新建一个独立页面
本地开发	hexo server	hexo s	启动本地预览服务器
生成网站	hexo generate	hexo g	生成静态文件到public目录
清理缓存	hexo clean	hexo clean	清除缓存和已生成的public目录
部署	hexo deploy	hexo d	部署网站（仅用于OSS等传统方式）
版本查询	hexo version	hexo v	查询Hexo及相关组件版本
组合命令	hexo g -d	hexo g -d	先生成，再部署
	hexo clean && hexo g	-	先清理，再生成
	hexo clean && hexo d -g	-	一键三连：清理、生成并部署
NPM 脚本	npm run pub	-	（推荐）执行在package.json中自定义的组合命令