运用hexo建立博客的几个坑

本文总结了在使用hexo搭建博客过程中遇到的问题,包括hexo更新导致的npm包缺少、spawn ENOENT错误、git相关错误(如无法获取github仓库、远端拒绝访问、无修改提示)以及github pages的css和js路径错误。针对这些问题,提供了详细的解决方法,如安装缺失的npm包、配置git环境变量、初始化git项目、配置公钥、调整.gitignore等。
摘要由CSDN通过智能技术生成

欢迎访文我的博客YangChen’s Blog
经过差不多4个多小时的折腾终于完成了hexo+github pages的建站,申请的域名还在审核所以先暂用github上的域名吧。
建立博客的过程十分曲折,比我预计的多出了不少时间,因为遇到了一些小碎坑,在此把这些碎坑整理一下,由于错误没有截图,所以全凭记忆力的报错信息吧。

1、hexo更新导致npm包缺少

在建立过程中第一个问题出现在部署到github上,在敲入hexo deploy后会报出缺少node_modules的错误,这是由于hexo跟新到3.0导致的,解决办法:执行npm install hexo-deployer-git --save安装缺少的依赖包,并将hexo下的_config.ymltype改为git,这样就解决了hexo更新带来的无法自动部署到github上的问题

2、spawn ENOENT问题

此问题是在hexo deploy后出现的,原因是hexo会调用git的命令,如果环境变量中没有git的话就会出现这个错误,解决方法:在环境变量path中添加git的环境变量C:\Program Files (x86)\Git\bin;C:\Program Files (x86)\Git\libexec\git-core

3、git相关错误

3.1无法获取到github仓库

这是由于hexo init之后hexo文件夹里缺少.git文件夹,hexo在执行git commit时没有远端地址导致。解决方法:git init一下初始化git项目

3.2远端拒绝访问

这种问题八成是由于公钥导致,先执行ssh -T git@github.com确定是否能够访问github,若出现拒绝则需要配置公钥,要公钥添加至自己的github主页下。

3.3修改博客后执行部署提示无修改

这种问题出现在最初不使用hexo部署,使用git命令部署后,再使用hexo部署后出现,因为hexo项目下.gitignore忽略了public下所有文件,而hexo编译后的静态文件都在pulic下。解决方法:执行hexo generate后执行git add .然后再次执行hexo d即可部署到github上

3.4以上操作不要使用cmd用git bash操作

4、github pages css及js路径错误

如果初次部署不是通过hexo的话就会出现这种错误,解决方案如下:
1、遵守github pages的命名规则,相关链接:https://pages.github.com/。在官方说明第二条中明确写到

Head over to GitHub and create a new repository named username.github.io, where username is your username (or organization name) on GitHub.

仓库命名规则要按照username.github.io规则,username是自己的github名字,不可以自己随便取名
2、初次部署使用hexo d来部署,分支名在_config.yml设置

最后总结下比较顺畅的建站思路:

Created with Raphaël 2.1.0
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值