基于Hexo的Matery主题博客部署问题与解决方案汇总


版本问题

  • 以下是我目前使用的各软件版本。这个版本可以实现目前已经探索到的所有的功能,推荐使用以下版本。
hexo: 4.2.0
hexo-cli: 4.2.0
os: Linux 5.4.0-48-generic linux x64
node: 14.12.0
v8: 8.4.371.19-node.16
uv: 1.39.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.16.0
modules: 83
nghttp2: 1.41.0
napi: 7
llhttp: 2.1.2
openssl: 1.1.1g
cldr: 37.0
icu: 67.1
tz: 2020a
unicode: 13.0

npm包管理器问题

  • 该包管理器的源默认是在国外,如果你是在中国大陆的话,推荐使用阿里的源,这个源可以大大增加下载速度,提升效率。执行下面的命令可以自动换源。
sudo npm config set -g registry https://registry.npm.taobao.org

Node.js版本问题

  • Node.js的最低版本限制与Hexo版本的对应关系
Hexo版本 最低兼容Node.js版本
5.0+ 10.13.0
4.1 - 4.2 8.10
4.0 8.6
3.3 - 3.9 6.9
3.2 - 3.3 0.12
3.0 - 3.1 0.10 or iojs
0.0.1 - 2.8 0.10

变换Hexo版本问题

  • Hexo版本可以很容易地变换,通过以下命令就可以进行变换,注意,Hexo可供下载的版本可以在其对应的github上的releases板块查询到,不能将Hexo改到没有的版本上去,这样脚本会报错。
npm i hexo@4.2.0    #将版本更换为4.2.0
npm i hexo@5.1.1    #将版本更换为5.1.1

关于Hexo不能在CodeBlock里面正确显示curly bracket的问题

  • 这个问题跟Hexo的版本有关,如果你是安装的5.0.0及以上的版本,会遇到这个问题,解决方案就是把你的hexo版本降低到4.x.x。这就可以非常完美地解决这个问题。但是,也不可以无限降低,我本人在尝试的时候发现当版本降低到4.1.1及以下时,Hexo就不能正常工作了,不清楚这是什么问题。推荐的版本是4.2.04.2.1

关于博客在本地可以显示,但挂载到Github上的时候就无法访问的问题

  • 这个问题的原因很大可能是因为你的DNS服务商的问题,有的DNS服务商会故意屏蔽部分域名,你可以试一下改变DNS服务商,在这里推荐的服务商是阿里或者腾讯。

未完待续…


文章作者: 南航古惑仔
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 南航古惑仔 !
  目录