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

📌环境说明:Hexo框架 + Github搭载 + Butterfly主题

改错原则

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

ZZ错误示例

  1. 编译.yml.md出错
    • 冒号是否为英文格式(英文)
    • 冒号后是否有空格(必须得有空格)
    • 缩进是否正确(严格缩进)

其他错误

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

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


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

    去国际版的官网注册,国内版的填写serverURL(需要域名备案)。


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

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


  4. 文章阅读量问题

    特别大:localhost不用管

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


未完待续…