hexo版本升级

1. 准备工作

1.1. 备份源文件

版本升级以前一定要先备份源文件,防止后面一些插件升级出现bug

1.2. npm速度太慢

如果npm install速度过慢,可安装cnpm淘宝镜像替代:

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

安装好了就可以使用cnpm来替代npm进行依赖的下载了:

1
cnpm install

2. 版本升级

先查看hexo版本:

1
hexo version

升级命令如下:

1
2
3
npm i hexo-cli -g
npm update
hexo version

3. 插件升级

上面升级命令不够正确(插件没有升级,不过插件升级可能会导致bug,要事先备份好源文件),继续往下操作:

3.1. 检查插件是否有升级

1
2
npm install -g npm-check
npm-check

3.2. 升级系统中的插件

1
2
npm install -g npm-upgrade
npm-upgrade

3.3. 更新全局包

1
npm update -g

3.4. 更新生产环境依赖包

1
npm update --save

3.5. 再次查看版本号

1
hexo version

4. 出现的问题

升级插件后报错:

1
hexo TypeError [ERR_INVALID_URL]: Invalid URL

主要是因为某些插件升级后有bug,需要退版本,解决方法如下:

  • 删除node_modules文件夹

  • 把稳定版本的package.jsonpackage-lock.json复制到当前文件夹并覆盖

  • npm install

5. hexo 5.0升级

5.1. 升级方法

2020.7.29 To upgrade to Hexo v5, change the following line in your package.json,

1
2
3
4
package.json

- "hexo": "^4.2.1",
+ "hexo": "^5.0.0",

然后

1
2
3
npm i hexo-cli -g
npm update
hexo version

5.2. 存在的问题

升级hexo 5.0后,hexo s后,提示:

1
2
INFO  Validating config
WARN Deprecated config detected: "use_date_for_updated" is deprecated, please use "updated_option" instead. See https://hexo.io/docs/configuration for more details.

5.3. 解决方法

站点配置文件_config.yml

1
2
- use_date_for_updated: false
+ updated_option: mtime

1
2
3
4
5
Hexo 4.0.0 提供的 use_date_for_updated 配置项现已被 updated_option 替代。

use_date_for_updated: true 现在等价于 updated_option: 'date'
use_date_for_updated: false 现在等价于 updated_option: 'mtime'
//如果从hexo 4.0升级到5.0,这里应当是updated_option: mtime(不要引号)

6. 参考链接