Hexo 博客安装、备份、恢复和升级

Hexo 是目前很流行的一个博客框架，目前搜索引擎中搜索到的自建博客十有七八都是使用的 Hexo，本博客用的也正是 Hexo。由于 Hexo 官方文档中安装部分搞得人晕头转向，所以本文整理记录一下 Hexo 博客安装、部署、备份 / 恢复以及升级的主要步骤和注意事项，力求简单清爽，供参考。

初装

1. 安装 nodejs 和 npm

   $ pacman -S npm

   也可以直接在 Pamac 包管理器中搜索 npm 安装。nodejs 作为 npm 的依赖会自动安装。pacman 是 Manjaro Linux 和 Arch Linux 的包管理软件，其他发行版命令不同但方法类似。

2. 创建博客源程序目录，并安装 Hexo 到此目录

   $ mkdir hexo-src && cd hexo-src
   $ npm install hexo

   此命令将 hexo 安装到 hexo-src 目录的 node_modules 中。

3. 修改 PATH（可选）

   将以下内容写入 ~/.bashrc 最后一行（如果用的是 zsh 就写到 ~/.zshrc），然后执行 source ~/.bashrc 命令。

   export "PATH=$PATH:$HOME/hexo-src/node_modules/.bin"

   这一步是为了能在命令行中直接使用 hexo 命令。也可以不进行这一步，只是以后需要用 npx hexo 命令代替。此处假定 hexo 目录在用户 home 目录中，如不同请修改命令。

4. 进行博客初始化

   $ hexo init # 或者 npx hexo init
   $ npm install

5. 完成

部署 / 备份

推荐 使用 GitHub Actions 部署和备份博客。

恢复

1. 安装 nodejs 和 npm

2. 克隆源程序仓库

   $ git clone git@github.com:<username>/hexo-src.git

3. 安装 hexo 和依赖模块

   $ cd hexo-src
   $ npm install

   此命令会读取目录中的 package.json 并自动安装 hexo 及所需的模块到 node_modules 目录中。

4. 修改 PATH（可选）

5. 完成

升级

$ npm update

执行完注意一下输出信息，可能有包存在冲突没有给自动升级，需要自行解决冲突或者强制升级。

参考

https://github.com/hexojs/hexo/issues/2508