Hexo搭建个人博客：从放弃到踩坑

封面

前言

相信每一位使用Hexo搭建博客的博主在搭建过程中都踩过大大小小的坑…如果官方文档有解决方法的话还好办，没有就只能老老实实去百度了…

经过两天的努力，我的博客终于搭成了，下面就盘点下我所踩过的坑吧…

遇到坑后建议先寻找官方的文档，看看里面有没有解决方案：

那些“坑”：

1.运行后网页显示代码：

1
extends includes/layout.pug block content #recent-posts.recent-posts include includes/recent-posts.pug include includes/pagination.pug #aside_content.aside_content include includes/aside.pug

错误.png

  • 下载安装：
1
npm install hexo-renderer-pug hexo-renderer-stylus --save

or 

1
`yarn add hexo-renderer-pug hexo-renderer-stylus

2.部署后提示：ERROR Deployer not found: git

  • 下面两种方法，第一种不行就用第二种：
1
npm install `--`save hexo-deployer-git

or

1
npm install hexo-deployer-git --save

3.提示hexo INFO Validating config

  • 下载安装
1
2
3
npm install -g cnpm --registry=https:registry.npm.taobao.org

cnpm install -g hexo-cli

如果还不行就检查你的站点配置文件_config.yml中最后部署到GitHub的分支

从2020.10.1开始github默认分支从master改为了main，许多旧教程还是还是默认master，将master改为main即可：

1
2
3
4
deploy:
  type: git
  repository: git@github.com:用户名/用户名.github.io.git
  branch: main

4.提示什么我忘记记录下来了，总之是因为版本过低

检查你的Node.js及Git版本是否为最新版：

Win+R 输入 cmd 并打开，依次输入： 

1
2
3
node -v
npm -v
git --version

后回车，检查程序版本号；

版本号.png

5.Butterfly主题无导航菜单和社交图标

  • 在主题配置文件_config.butterfly.yml中删除相应代码前的#号，如下：
1
2
3
4
5
6
7
8
9
10
menu:
   主页: / || fas fa-home
   时间轴: /archives/ || fas fa-archive
   标签: /tags/ || fas fa-tags
   分类: /categories/ || fas fa-folder-open
   清单||fas fa-list:
     - 音乐 || /music/ || fas fa-music
     - 电影 || /movies/ || fas fa-video
   友链: /link/ || fas fa-link
   关于: /about/ || fas fa-heart
1
2
3
4
5
6
# social settings (社交圖標設置)
# formal:
# icon: link || the description
social:
   fab fa-github: https://github.com/xxxxxx || Github
   fas fa-envelope: mailto:xxxxxx@gmail.com || Email

6.安装Aplayer时报错

安装Aplayer报错

  • 步骤一：删除C:\Users{账户}\下的.npmrc文件…
    注意：这个文件默认是被隐藏的，需要选择将隐藏取消掉才能看见
  • 步骤二：执行以下命令进行清理：
1
npm cache clean --force

​ 但是会报以下错误：

clean报错

​ 解决方法：将博客根目录下的node_modules全部删除后再执行步骤二命令即可！

7.运行hexo d时提示client_loop: send disconnect: Connection reset by peer

如图：

原因：http.postBuffer默认上限为1M

运行以下代码将上限改大就行：

1
git config --global http.postBuffer 524288000

之后便能成功上传了！

8.上传时提示fatal: Could not read from remote repository.Please make sure you have the correct access rights and the repository exists.

hexo d时报错：

发现是和仓库的连接问题，输入ssh -T git@github.com后提示：

发现无法连接了，于是重新生成ssh密钥文件：

再检测一遍连接状态，提示成功后，再次上传即可！

暂时就这么多…以后遇到问题还会更新的。

希望这篇博文永远也不用再更新…

End