本文最后更新于 2024-10-18,文章内容距离上一次更新已经过去了很久啦,可能已经过时了,请谨慎参考喵。

title: Hexo常用插件和Bug汇总(持续更新中)
tags:
  - npm
  - Hexo
categories:
  - Hexo
top_img: false
cover: '/upload/cdn0files/20200727142233.jpeg'
abbrlink: af539879
date: 2020-07-27 09:54:48

只针对 Bitterfly 主题

常用插件

2020.8.16更新

这是取消备用站点、取消PWA等功能之后的,目前很简约的 package.json :

{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "5.0.2"
  },
  "dependencies": {
    "hexo": "^5.0.2",
    "hexo-abbrlink": "^2.2.1",
    "hexo-bilibili-bangumi": "^1.5.0",
    "hexo-deployer-git": "^2.1.0",
    "hexo-generator-archive": "^1.0.0",
    "hexo-generator-category": "^1.0.0",
    "hexo-generator-index": "^2.0.0",
    "hexo-generator-search": "^2.4.0",
    "hexo-generator-tag": "^1.0.0",
    "hexo-renderer-ejs": "^1.0.0",
    "hexo-renderer-marked": "^3.0.0",
    "hexo-renderer-pug": "^1.0.0",
    "hexo-renderer-stylus": "^1.1.0",
    "hexo-server": "^2.0.0",
    "hexo-tag-aplayer": "^3.0.4",
    "hexo-wordcount": "^6.0.1"
  },
  "devDependencies": {}
}

主题渲染插件

npm install hexo-renderer-pug hexo-renderer-stylus --save

Git 推送插件

npm install hexo-deployer-git --save

音乐播放器插件

npm install hexo-tag-aplayer --save

哔哩哔哩追番页面生成插件

npm install hexo-bilibili-bangumi --save

RSS生成插件

npm install hexo-generator-feed --save

文章置顶插件

npm install hexo-generator-index-pin-top --save

本地搜索插件

npm install hexo-generator-search --save

字数统计插件

npm install hexo-wordcount --save

永久链接生成插件

npm install hexo-abbrlink --save

百度Sitemap生成插件

npm install hexo-generator-baidu-sitemap@0.1.4 --save

百度主动推送插件

npm install hexo-baidu-url-submit --save

SiteMap生成插件

npm install hexo-generator-sitemap --save

Gulp 压缩插件

慎重使用,可能会导致 CSS 样式丢失,使用方法请参考:博客开启 Gulp 压缩

npm install gulp-cli --global
npm install gulp-htmlclean --save-dev
npm install gulp-htmlmin --save
npm install gulp-clean-css --save-dev
npm install gulp-uglify --save-dev
npm install terser
npm install workbox-build gulp --save-dev

gulp-imagemin 这个插件比较特殊,慎重使用

npm install gulp-imagemin --save-dev

常见报错

node 警告

报错截图

应该来说是正常的,由于包版本和系统兼容性问题导致的,只要不影响功能,即可忽视。

网页公告栏不显示内容

昨天修改了公告栏,加上了小程序和公众号二维码,但是突然公告栏内容消失,检查了好多次都不知道错误在哪,然后就把之前备份的配置文件拿出来对比,发现了错误所在:

配置信息

原来是这里缺少了一个缩进(图中已修复)

尽管这是个再微不足道的错误,但是却提醒了我,配置文件是非常严谨的,即使少一个空格也可能导致报错。

PWA 报错图标路径找不到

报错截图

图标路径不对,检查图标路径,务必要让 manifest.json 文件和配置文件中的 PWA 访问到。

中间最长的哪一行是因为图标格式不合格,检查图标尺寸。

PWA 报错安全服务重复

控制台报错信息

如果控制台报错这个,说明你的 PWA 配置多余,就是可能 offline 和 PWA 同时开启,建议注释掉 offline 的配置并卸载 hexo-offline 插件。

文章的TOC无法点击

目前 Butterfly 3.0 没有适配 Hexo 5.0 ,会导致文章的中文标题无法识别,所以导致标题列表无法点击,有两个方法可以解决:

  1. 回退版本:npm install hexo@4.2.1 即可
  2. 群里大佬提供的方法:

修改 main.js

img

即可

hexo d到gitee时报错

报错信息

报错信息翻译:

根据提示执行 git prune 会报错不是一个Git仓库,究其原因,是因为 hexo d 的机制,是把 pubilc 下的所有文件复制到 .deploy_git 文件夹下,再进行推送,所以整个博客目录在不执行 hexo d 时并不是一个Git仓库,所以这就无法解决这个问题,但是推送到github和coding时正常,这就很奇怪,我找不到原因,得不出解决方法,如果有大佬知道,请留言,感激不尽。

2020.8.8更新,已解决,在执行 hexo d 之前 cd 进入 .deploy_git 文件夹内,执行 git prune 即可

2020.8.11更新,上面的那种方法治标不治本,后来又开始反复,今天我发现了另一种方法,就是把gitee的推送地址放到最下面就可以解决了,,,这可能是gitee机制和GitHub不一样的原因吧

更新主题报错

和这个报错信息相似

只要和这个报错信息相似的,请检查你的配置文件是否迁移完全,各项新的配置格式是否正确,我这次报错就因为少了一个空格,让我好找,找不同实在是太费眼睛了。

hexo d到github报错请求出错

报错信息:

报错信息

应该是git凭证失效,更新凭证即可,下载地址:git for Windows

安装凭证

文章设置更新日期不生效

很多时候因为意外导致文章的最后修改时期变化,从而引发文章更新日期的变化,如果我们不需要这种变化,就要手动设置更新日期,但是我突然发现,设置 update 并不生效,这是怎么回事呢?

经过群里大佬的提醒,我才发现我单词拼错了,更新日期应该是 updated