有幸在知乎知道了GitHub,然后逐渐尝试使用GitHub。查资料的时候偶尔看到说可以利用GitHub搭建个人博客,感觉很高大上的东西。
昨天搜了一些教程,照着把博客搭出来了,比想象中的简单,但是也遇到了一些问题,在此记录下来。
我用的Windows7,其他系统安装的情况可能会有所不同。
1. 安装
2. Hexo相关操作
- 安装完Git和Node.js之后,在任意位置点击鼠标右键,选择Git Bash,输入命令:
npm install -g hexo安装hexo。 - 在Hexo文件夹下点击鼠标右键,打开Git Bash,执行
hexo init,Hexo会建立网站所需的所有文件。 - 输入
npm install安装依赖包。 - 本地Hexo博客建好了,在Hexo文件夹下打开Git Bash执行
hexo s -g,然后打开浏览器输入localhost:4000查看。
3. GitHub相关操作
- 在个人的GitHub账号下,新建一个仓库,仓库名一定形如:
[username].github.io,例如zz0116.github.io。
- 在创建好的Repository下,找到clone URL,复制地址。

- 在Hexo文件夹里找到
_config.yml(全局配置文件),打开后对deploy部分进行修改。
4. 部署Hexo到GiHub
- 打开
C:\Users\xxx\.ssh,查看是否有文件,如果有的话,直接删除里面的所有文件。 - 在Git Bash里面输入
ssh -keygen -t rsa -C "xxxx@xxx.com"邮箱为注册GitHub时的邮箱,回车后会提示输入passphrase,直接回车,然后输入以下命令:
- 在
C:\Users\xxx\.ssh里找到id_rsa.pub文件,打开后复制内容,然后打开你的GitHub的setting,点击New SSH key如图,
,将刚刚复制的key粘贴进去,Title可以随意取,完成SSH key的添加。 - 在Git Bash里面输入
ssh -T git@github.com命令,在询问continue connecting时输入yes。 - 最后一步,输入
hexo d -g。整个GitHub+Hexo博客就搭建成功啦,打开浏览器输入http://[username].github.io,例如zz0116.github.io,就可以看到搭建好的博客了!
Tips:
- 有些教程在对
_config.yml里的deploy修改部分,设置type: github,会出现问题,看起来似乎是空格的问题,而且去掉空格就不报错,但是后面的部署没法成功。在_config.yml里进行配置的时候,冒号后面的空格是一定要的。这里把github改成git就好了。 hexo clean可以对hexo g生成的文件进行清除。- 从头到尾都不需要
git add或者git commit命令。hexo d -g即会将本地的修改推送到GitHub上。 - Hexo文件夹可以随意移动。
- 解决Cannot GET /的办法:
npm install hexo-renderer-ejs --save,npm install hexo-renderer-stylus --save和npm install hexo-renderer-marked --save然后重新输入hexo s -g即可。 - 解决
hexo server命令没有作用的办法:install hexo-server --save。 - (2016.07.17更新)尝试用GoogleDrive时出了点问题,导致一直是404,本地的
localhost:4000能打开,而且没一点问题,也能提交到github。思来想去只有一个原因,就是该提交的.html文件没有提交上去,据此将hexo安装的步骤重复了一遍,当然提前把theme、source、public几个文件夹以及_config.yml配置文件备份了一份。重装hexo果然好了,再将几个文件夹和文件替换,完美解决!