利用GitHub+Node.js+Hexo搭建个人博客

本篇是自己在搭建Hexo博客平台时的一个过程记录。（2019。9.13实测有效）

GitHub

账号注册

因为此文所搭建的个人博客是基于GitHub平台服务的，所以首先是注册GitHub，当然已有账号的跳过此步；

创建Repository

点击开始后，跳转至Create a new repository，这边Repository name命名规则就是username.github.io，其中username就是你注册时的username。

usename 一定要改成账号名，不要改成其他的，否则就出现  https://growvv.github.io/rogn.github.io/ 这种尴尬的情况！

Settings

点击创建之后页面跳转至project内，这时我们点击settings

这时我们在该页面往下拖动网页，找到GitHub Pages，之后点击Choose a theme选择页面主题，这边我们就暂时选择默认的主题（因为后面我会更换为NexT主题的），然后点击Select theme。

GitHub Page

点击选择主题后，页面会跳转至该Repository的可以说是主页吧，如下所示。上面有提醒主题更换，也有生成一个 index.md/markdown 文件。这时我们再去刚才的setting设置里去看刚刚的GitHub Pages那边，会有显示你的url，这就是你未来博客“搭建”在该网址上。

  此时点击该url访问到的也就是你未来个人博客将会展示的样子

Node.Js

下载安装

传送门：NodeJs，选择对应的版本进行下载，安装的话就点点点，这边就不在叙述了。

 软件安装完成后，打开cmd界面，输入node -v和npm -v（注意查看环境变量部分是否已经正确），查验其版本，确认是否安装成功。

Git

下载安装

传送门：git，选择对应版本下载安装。安装过程这边也不叙述了，就点点点。

安装完成后，可能还要手动添加一下环境变量吧，看下版本git --version

 安装Hexo

在命令行输入：

npm install -g hexo-cli

 之后创建一个文件夹（搭建博客的相关文件存放于此），此处我命名为test（可自主命名），在该文件夹路径下打开cmd（在文件夹下的路径输入框中输入cmd并回车），或者直接在cmd中切换到该文件夹下，输入：

hexo init

（执行这条命令前，必须确保文件夹为空

如果此命令出错，请见本文最后一段。

运行后的样子，其中在下载默认主题landscape时，出现了一些乱码，不过这些问题不大，最后显示添加add成功就行：

 此时文件夹下多了如下一些内容：

本地运行

此时还是在该文件夹路径下的cmd里输入（-p 5000 表示设置端口号为5000；若不写这个，则默认为4000，但可能会出现端口号被占用的情况，导致网页无法打开）：

hexo server -p 5000

此时浏览器上输入http://localhost:5000/，访问到博客的默认界面：

我们可以在这hello_world_blog.md文件里添加自己的博客内容，因为我是用作测试的，所以什么内容这边就不贴图了。重新运行 hexo server -p 5000，访问localhost可以看到，网页中有了内容添加。

其他相关的命令如下：

• hexo clean 删除public文件夹及其内容（public文件夹的内容即为上传至GitHub Repositoriy的内容）
• hexo generate 或 hexo g 生成上传至GitHub的内容，即public文件夹
• hexo deploy 或 hexo d 上传至GitHub（需进行配置）

这时候，博客的基本设置（主题设置留待以后）都已弄好，接下来就是解决将博客内容上传至GitHub上的问题。

配置个人信息

打开Git Bash，配置个人信息，分别输入如下命令，yourname即GitHub注册时的用户名，yourEmail即注册时的邮箱账号，以及生成秘钥：

git config --global user.name "yourname"
git config --global user.email "yourEmail"
ssh-keygen -t rsa -C "yourEmail"

需要带上双引号

在秘钥生成后，会有对应的存放文件地址，去该地址中，找到id_rsa.pub文件，复制里面的内容，粘贴至GitHub中，点击右上角用户头像下的Settings，之后点击左侧的SSH and GPG keys，找到New SSH key点击，输入title，并将之前复制的内容粘贴到下面的key中，最后点击Add SSH key，完成：

配置Deployment

去博客总目录下的_config.yml文件中，找到deploy部分，添加如下（yourname就是GitHub的用户名）：

deploy:
  type: git
  repo: https://github.com/yourname/yourname.github.io.git
  branch: master

整体流程

至此，除了博客主题（目前采用默认主题）外，其他基本设置都已弄好。
整体的写文上传等操作流程为：

1. hexo new newBlog
2. hexo clean
3. hexo g
4. hexo d

遇到的问题

hexo d命令报错 ERROR Deployer not found: git

解决方法：

这是因为没安装hexo-deployer-git插件，在站点目录下输入下面的插件安装就好了：

npm install hexo-deployer-git --save

参考链接：

1. https://asdfv1929.github.io/2017/11/18/hexo-next-blog/

2. https://blog.csdn.net/qq_21808961/article/details/84476504