📌本文主要讲述Hexo博客搭建中遇到的各类问题

封面图

改错原则

  1. 仔细查看 Hexo文档Butterfly主题文档 ,大部分问题都是因为没好好看文档,一定要细心。
  2. 是否清除浏览器缓存以及刷新CDN缓存
  3. 是否执行 hexo clean

错误示例

  1. 编译 .yml.md 出错

    • 冒号是否为英文格式(英文)
    • 冒号后是否有空格(必须得有空格)
    • 缩进是否正确(严格缩进)

    这种错误就是不了解 yaml 的语法格式

其他错误

  1. 编译后出现类似 appId 的错误

    安装插件后通常我们去配置 _config 文件,但有一部分插件是需要你去对应官网注册配置,才能得到appId,大部分是因为你没有填写,所以报空错误。


  2. 插件安装完成,也填写 appId ,但插件在前端报 serverURL 的错误

    国内版的需要填写serverURL(需要域名备案)。


  3. hexo-douban 插件不生效,每次都是0篇

    排除你的配置问题,大部分是因为作者已经不维护这个插件了,可以降低npm版本再次测试。


  4. 文章阅读量问题

    特别大:localhost不用管

    数量不对:卜算子的问题,经测试有的浏览器正常,有的错误,文档说是跟 pjax 有关。


未完待续…