利用Github搭建自己的个人博客，看完就会的保姆级教程

作为一名喜欢技术的爱好者，平时喜欢把自己学习技术的心得或者一些踩坑、易错的过程记录下来，首选的是技术平台(博客)，今天辰哥来教大家如何利用Github来搭建一个自己的个人博客平台。

相信Github大家都有听过，甚至是经常用，除了可以作为开源源码的交流平台，还提供了搭建博客的功能。目前一些大佬、老师的博客用的就是Github搭建的（辰哥见过很多）。

访问地址： https://liyunchen.github.io

01

环境准备

在搭建Github博客之前，先准备一下环境（按照下方的顺序来安装，别弄混了）。

1.安装git 官方地址：https://git-scm.com/

1、访问git官方地址，下载对应的安装包，进行安装（简单的点击下一步）。

2、安装好之后，鼠标右键可以看到：Git Bash Here，点击后打开了。

3、输入：git --version

出现这个说明git安装成功。

2.安装node.js 官方地址：https://nodejs.org/en/download/

1、访问nodejs官方地址，下载对应的安装包，进行安装（简单的点击下一步）。

2、安装好之后，配置环境变量，并在终端里面输入：node -v

出现这个说明nodejs安装成功~

3.安装Hexo 安装命令：npm install hexo -g

测试是否安装成功，命令：hexo -v

4.安装hexo依赖 命令：npm install --save hexo-deployer-git

02

git配置SSH key

相信看到本文的你应该听过github，并且也注册了自己的github账号，如果现在还没有的可以去github注册一个账号。

为什么要配置SSH key？ 目的：可以免密的将本地的源码和资源上传到github，无需要每次都输账号和密码。

先看本地是否配置好SSH key（命令：cd ~/.ssh）

这里辰哥之前就配置了，现在删除配置，重新配置一边，方便读者可以跟着进行配置。

再次查看：

可以看到提示：/c/Users/Administrator/.ssh: No such file or directory

备注： 因为ssh配置好之后是保存到 c:/用户/Administrator/.ssh

1.配置ssh

先生成ssh key ssh-keygen -t rsa -C "邮件地址" 备注：这里的邮件地址是github账号绑定的邮件地址

输入生成命令：ssh-keygen -t rsa -C "邮件地址"后。连续回车三次即可：

可以看到在用户文件夹下生成了一个ssh文件夹：

进入到ssh文件夹，复制id_rsa.pub文件里全部内容：

接着打开github主页，点击个人设置，点击左侧的SSH and GPG keys，点击New SSH key ：

将id_rsa.pub复制的内容粘贴到key中，title随便起一个就行。

点击 Add SSH key。

测试是否成功： ssh -T git@github.com

输入测试命令后，接着输入yes，出现下面这个提示说明成功：

配置账号和密码：

$ git config --global user.name "liyunchen" #你的github用户名$ git config --global user.email "xxx@163.com" #填写你的github注册邮箱

备注：用户名和邮箱记得改为自己的

03

搭建个人博客

1.新建博客

开始之前先介绍一下heox的基本命令：

hexo new "postName" #新建文章hexo new page "pageName" #新建页面hexo generate #生成静态页面至public目录hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）hexo deploy #部署到GitHubhexo help  # 查看帮助hexo version  #查看Hexo的版本

对应的缩写，比如： hexo n == hexo new hexo g == hexo generate

新建一个保存博客的存放目录，比如辰哥的是：D:\公众号\0722。

进入到本地博客存放目录 初始化 个人博客 命令：hexo init

可以看到博客存放目录出现了如下内容：

#生成静态网页 命令：hexo g #预览 命令：hexo s

报错解决： 问题：hexo g报错,line.mathALL is not funciton问题解决 原因：nodejs版本低于12 解决：两种方法 方法1）请将nodejs升级到高于12.0.0的版本 方法2）config.xml中的 highlight->enable的值从true更改为false，这样可以避免异常。

在浏览器这访问： http://localhost:4000/

可以看到访问没问题。

但这个只是在本地预览，接着将这个博客部署到github。

2.部署到github

新建一个github仓库：

给仓库起个名称，注意！注意！注意！

仓库名称格式：用户名.github.io

辰哥的仓库名称为：liyunchen.github.io。

因为这个仓库名称将作为你github博客的访问地址：

编辑_config.yml，_config.yml在博客存放目录下：

deploy:  type: git  repository: git@github.com:liyunchen/liyunchen.github.io.git  branch: main

repository仓库地址改为自己的。

branch看自己的github仓库是master还是main，辰哥这里是main，所以就填写main。

发布到github 命令：hexo d

在浏览器访问 https://liyunchen.github.io/

可以看到成功访问。

这个博客地址已经是部署到了公网，感兴趣的读者也可以访问

04

编写博客

搭建好博客之后，日常中肯定是需要编写博客并且同步到github，辰哥来带大家写一篇博客。

新建一篇名为：chenge-first-blog的博客 命令：hexo new 'chenge-first-blog'

查看对应的文件夹：

可以看到生成了一个chenge-first-blog.md文件，通过这个md文件去写博客。

默认的内容是这样的：

---title: chenge-first-blogdate: 2021-07-22 14:08:14tags:---这里方开始编写正文

开始编写博客内容（markdown格式）：

这里辰哥以之前的一篇文章为例。

其中的<!--more-->，作用是在查看文章的时候，点击more的时候再加载全部的文章内容。

编写好之后，开始部署到github。

1.生成html文件 hexo g 2.上传到github hexo d

再次访问：

https://liyunchen.github.io/

可以看到编写的博客已经同步到github平台，并且<!--more-->的作用也可以看到了：read more。

05

小结

本文从0到1搭建了自己的个人博客，过程很详细，并且可能会出现的错误都做出了说明和解决方法。绝对的保姆级教程，看完就会！

最后附上辰哥搭建好的博客地址，所有人都有可以访问。

访问地址： https://liyunchen.github.io

 如果喜欢本文欢迎 在看丨留言丨分享至朋友圈 三连
 热文推荐  
看AWS应对云计算安全威胁
揭秘预训练语言模型的“魔力”之源好多大咖曾看他的书学习Java！
业界首本云网络图书发布