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 | npm i hexo-cli -g |
注意:如果升级后报错,大概率是因为安装的某个插件的问题(如hexo升级5.4后,hexo-cake-moon-menu插件导致报错,就需卸载此插件,当然也有可能是主题和这个插件不兼容),这时就需要排查是哪个插件的问题,最直接的方法就是重新初始化hexo,所以说升级前备份源文件是及其重要的。
3. 插件升级
上面升级命令不够正确(插件没有升级,不过插件升级可能会导致bug,要事先备份好源文件),继续往下操作:
3.1. 检查插件是否有升级
1 | npm install -g npm-check |
3.2. 升级系统中的插件
1 | npm install -g 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.json
和package-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 | package.json |
然后
1 | npm i hexo-cli -g |
5.2. 存在的问题
升级hexo 5.0后,hexo s
后,提示:
1 | INFO Validating config |
5.3. 解决方法
站点配置文件_config.yml
1 | - use_date_for_updated: false |
1 | Hexo 4.0.0 提供的 use_date_for_updated 配置项现已被 updated_option 替代。 |