【教程】HEXO博客搭建教程与问题汇总

HEXO
2.3k 词

一、HEXO博客搭建全流程教学

【教程】零基础搭一个HEXO博客

二、HEXO博客搭建流程与运行中遇到的问题

1. 本地部署环节第四步“部署你的hexo框架”输入hexo init指令报错

  • 系未安装hexo，进入hexo官网或Github按照教程安装在hexo网站文件夹的命令提示符中输入对应指令安装hexo即可

HEXO官网

什么是 Hexo？

HEXO Github（需科学上网）

Hexo

Windows安装指令

npm install hexo-cli -g

Linux或macOS安装指令

brew install hexo

2. 本地部署环节第七步中编辑_config.vivia.yml文件插入图片连接时“相对文件路径”如何填写

什么是相对路径？相对路径的具体写法和用法

3. 本地部署环节第七步中Valine评论区头像不显示

  • 系网站连接问题，按照Valine官网“头像配置”部分将一、HEXO博客搭建全流程教学中Valine评论部分代码中的avatar指令全部替换成avatar_cdn指令即可

Valine官网

头像配置

指令替换：

将
avatar: mm
替换为
avatar_cdn: ‘https://cravatar.cn/avatar/‘

4. 把博客连接到github环节第二步输入hexo clean && hexo g && hexo d指令报错

  • 输入hexo clean && hexo g && hexo d指令后弹出以下报错

FATAL: unable to access ‘https://github.com/aaa（你的用户名）/aaa（你的用户名）.github.io/‘: Encountered end of file
Error: Spawn failed
at ChildProcess. (/usr/local/src/hexo/hanyubolg/node_modules/hexo-util/lib/spawn.js:51:21)
at ChildProcess.emit (events.js:376:20)
at Process.ChildProcess._handle.onexit (internal/child_process.js:277:12)
code: 128
Something’s wrong. Maybe you can find the solution here: %s https://hexo.io/docs/troubleshooting.html

解决教程

Hexo部署出现错误err: Error: Spawn failed解决方式

输入以下指令

git config –global core.autocrlf false

再重新输入

hexo clean && hexo g && hexo d

5. 使用Vercel加快国内访问环节添加New Project时，最底下部署环节报错，Project界面显示Not Deployment

  • 系未部署成功，该状态下即便在Domains界面成功链接了域名也无法从本地更新至线上

解决方案：添加New Project环节中将“Build and Output Settings”填写的所有内容全部删除，恢复默认状态空白提交

6. 网站搭建成功后Valine评论区报错“Code 403: Access denied by API domain white list, Please check your security domain”或“访问被API域名白名单拒绝，请检查你的安全域名设置”

  • 系未在Valine安全域名中添加hexo博客域名

解决教程

Valine评论插件报错：Code 403

解决方案

在LeanCloud的【应用 > 设置 > 安全中心 > Web安全域名】中添加hexo博客访问域名即可

7. 本地更新博客后，输入指令hexo clean && hexo g && hexo d报错，Github未更新

第一步：在系统搜索栏搜索CMD，选择“以管理员身份运行”

第二步：输入hexo博客根目录所在磁盘（以博主为例，博主的hexo博客根目录所在磁盘为E盘，则输入e:）

第三步：输入hexo博客根目录（以博主为例，博主的hexo博客根目录地址为E:\HEXO\blog，则输入cd hexo/blog）

第四步：输入指令npm install hexo-deployer-git –save
第五步：输入指令git init
第六步：输入指令git remote remove origin
第七步：输入指令git remote add origin https://github.com/你的GitHub用户名/你的GitHub用户名.github.io.git
第八步：输入指令hexo clean && hexo g && hexo d

  • 如果进行了上述步骤仍旧报错无法更新至Github，建议重启网络连接或重启电脑后重新使用hexo clean && hexo g && hexo d指令同步，或更换魔法工具

8. HEXO博客插入本地图片教程

教学网址：Hexo 中完美插入本地图片

9. 更改个人HEXO网站图标

第一步：在iconfont网站选择自己喜欢的图标并下载图片，将图片存于source文件夹
第二步：在_config.vivia.yml的favicon部分输入该图片的相对路径

留言