使用hexo+github搭建个人博客遇到过哪些坑

一、

fatal: Could not read from remote repository.
致命:无法读取远程存储库。
Please make sure you have the correct access rights and the repository exists.
请确保你有正确的访问权限和存储库的存在。

出现这种错误,有可能在配置_config.yml的时候,

deploy:
  type: git
  repo: http://github.com/wapchief/wapchief.github.io.git
  branch: master

repo:设置了SSH方式连接,在没有ssh证书的情况下是连接失败的。解决方法是把ssh,修改为https方式连接。
如果仍报错,把https改为http。

二、

ERROR Deployer not found: git

fatal: in unpopulated submodule '.deploy_git'

两个是一个错误,未安装部署工具,或者和之前安装的版本有冲突
执行安装命令:

npm install hexo-deployer-git --save

如果安装报错,就先清除一下再重新安装

rm -rf .deploy_git
npm install hexo-deployer-git --save

三、

fatal: unable to stat 'node_modules/hexo-deployer-git/node_modules/hexo-fs/node_modules/chokidar/node_modules/anymatch/node_modules/micromatch/node_modules/braces/node_modules/expand-range/node_modules/fill-range/node_modules/is-number/LICENSE': Filename too long

这种情况一般是在执行

git add .
git push
git commit

的时候会出现。
报错提示名字超长,或者路径超范围。
解决的方法有很多,选择升级git。
或者配置git

git config core.longpaths true

四、

相关工具问题

因为使用hexo+github需要用到多个工具。有时候不确定是不是安装的问题可以通过下面的命令测试是否安装成功

node -v
npm -v
git --version
hexo -v

如果都能正常显示版本信息,证明安装都没问题

五、

页面不能正常显示,或者404

检查根目录下的_config.yml文件是否配置正确,注意变量:后要加空格。
部署的时候,是根据branch判断部署的目录。

部署成功后,无需再使用git命令提交远程,已经自动在远程生成了页面文件。

还有种可能是主题有问题,关于主题可以去官网找,也可以去github,搜hexo theme。一般只要是用来搭建博客的都会有使用教程。

六、

关于分支和更换电脑问题

由于安装hexo的时候只在本地生成。而部署的时候只是把public目录里的文件和相关配置上传到github。
要想在远程也能管理,需要创建新的分支来存放源代码。

或者通过其他第三方托管平台来托管源码,像coding,码云等都可以。
在github上托管是公共的,如果需要安全也可以这个办法。

如果使用github分支,则使用

git fetch && git checkout hexo

在本地创建一个新的分支并推送到远程仓库,
然后

git add .
git commit -m '提交说明'
//强制提交到hexo分支
git push -f origin hexo

注意:在其他设备上克隆的时候,建议克隆下来之后把隐藏文件.deploy_git文件删除,否则容易冲突。

如果有其他问题可以,留言给我。看到一定会回复。
后面如果有新的问题,我也会在这篇文章中更新。


使用hexo+github免费搭建个人博客网站超详细教程
Hexo常见问题解决方案

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容