自从开始使用Hexo就没有变过,而现在版本已经从4.2到5.4。由于官方文档缺乏升级方面的内容,故记录一下踩坑过程。

准备工作

备份

将现有博客的文件夹除了node_modules外整个复制一份:

1
git archive -o blog.zip HEAD

升级node.js

关于node管理系统nvm的安装见此处

1
nvm install stable

升级hexo-cli

1
npm install -g hexo-cli

升级Hexo

与其说升级,不如说重装更合适一些,因为hexo自有一套初始化操作,不能直接npm install

新建临时空文件夹:

1
mkdir -p ~/tmp/blog && cd ~/tmp/blog

安装最新版Hexo:

1
npm i hexo@5.4.0

初始化:

1
hexo init

将生成的相关文件和现有文件进行比对和更新:删掉旧目录的node_modulesdb.jsonpackage.json等并用临时目录中新生成的替代,将旧_config.yml中的内容按新生成的模板增加项目和修改。

5.0版以后deployer不再是必需依赖,如果是用git方式部署需手动安装hexo-deployer-git

1
npm install hexo-deployer-git --save

最后直接在原文件夹中hexo g生成,hexo s测试一下。

参考资料

Hexo Documentation