心血来潮想搭建一个个人博客，但是又不想买域名买服务器，就在网上找了个简单的Hexo+GitHub的建站教程，没想到这么简单的教程我也能踩坑。下面大概记录一下安装流程以及安装过程中踩到的坑。
安装基本流程
安装主要是按照这个教程进行的（忽略个人网站域名相关部分）。主要步骤就以下几个：
- GitHub创建个人仓库
- 安装Git
- 安装Node.js（强烈推荐使用nvm安装稳定版本）
- 安装Hexo
- 推送网站
其中在安装node.js时，默认安装了当前的最新版本14.0.0（这是个大坑）。
踩坑
部署不上GitHub
按上面的流程操作完之后，本地能预览，但是部署不到GitHub上去。看了下md文档是在的，但是渲染出来的html文件都是空的（那为什么本地博客显示正常？？？）。。
网上搜索一番，首先尝试重启大法，即重新安装node.js和hexo等，没用。
然后尝试了更改_config.yml里面的deploy下repo的格式：
1 | repo: https://github.com/yourname/yourname.github.io.git |
or
1 | repo: git@github.com:yourname/yourname.github.io.git |
也没有用。
最后折腾了半天之后，终于在一个博客上看到可能是node.js的版本问题，这样又来到了第二个大坑。
nvm和node.js安装
由于使用的macOS，之前安装node.js是直接用brew安装的，默认安装的是最新版node。在某博客中看到最好不要使用brew安装node.js，而是采用nvm安装，使用nvm可以进行node.js的版本管理，可以随时切换node版本。nvm及node安装教程可以看这篇，mac下更详细的教程可以看这里和这里，以及别人踩过的坑。还有一篇Mac OSX下重装node.js供参考。
我安装nvm也碰到了路径问题，就是明明已经安装了nvm，但是用的时候却显示command not found。参考前面的几个博客，以及一顿google又折腾了半天安装好了nvm，然后安装了官方推荐稳定版本v12.6.0，然后再安装hexo，部署GitHub，问题完美解决。
但是重启终端后又说找不到nvm了！于是又有了nvm 重启终端失效的解决方法。
总结一下，血的教训就是安装软件或者包啥的一定要安装官方稳定版！
其他问题
还有很多别的常踩的坑可以参考Hexo常见问题解决方案。