作者：下里巴人

来自南京审计大学

前言:

相比其他大佬，作为小白的我写的搭建历程肯定漏洞百出o(╥﹏╥)o，但我还是会尽量考虑到一些操作细节，帮助大家避免我曾经遇到的问题（doge，就图一乐哈！，如果想要更详细的教程，请移步CSDN噢！

一.什么是博客？

指在博客（Blog或Weblog）的虚拟空间中发布文章等各种形式的过程。 简言之，Blog就是以网络作为载体，简易迅速便捷地发布自己的心得，及时有效轻松地与他人进行交流，再集丰富多彩的个性化展示于一体的综合性平台。不同的博客可能使用不同的编码，所以相互之间也不一定兼容。而且，很多博客都提供丰富多彩的模板或其他个性化方案，这使得不同的博客各具特色。Blog是继Email、BBS、ICQ之后出现的第四种网络交流方式，至今已十分受大家的欢迎，是网络时代的个人“读者文摘”，是以超级链接为入口的网络日记，是代表着新的生活方式和新的工作方式，更代表着新的学习方式。具体说来，博客（Blogger）这个概念解释为使用特定的软件，在网络上出版，发表和张贴个人文章的人。

来自百度百科

二.为何用hexo+github搭建个人博客？

建立博客存在的一些问题

  • 商业化的博客平台自由度低，广告多
  • 自己购买域名，服务器成本高
  • 需定期维护，过于耗费精力

如何解决以上问题？

基于开源框架搭建博客，直接在github page平台上托管我们的博客。无需关心网页源代码的具体生成细节，只需要用心写好博客内容即可
注：虽然这么说，但是我觉得还是挺麻烦的（doge ，当然，只是对我来说 O(∩_∩)O

下面，就开始正式进入我的艰难搭建之旅啦o(╥﹏╥)o

三.搭建流程

   工具介绍

Vscode

VSCode（全称：Visual Studio Code）是一款由微软开发且跨平台的免费源代码编辑器。 该软件支持语法高亮、代码自动补全（又称 IntelliSense）、代码重构、查看定义功能，并且内置了命令行工具和 Git 版本控制系统。

强烈推荐！！！！基本全栈都可以在这款编辑器中编写，且轻量化，支持中文！！是小白的福音！！

Git

Git（读音为/gɪt/）是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。 [1] 也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。

Hexo

Hexo是一款基于Nodejs的，快速、简洁且高效的博客框架。具有丰富的插件和主题，具有超快的速度。支持Makedown语法，可以方便快捷的编写博客文档。同时支持node命令，可以一键部署到GitHub Pages, Heroku 或其他平台。

Github

GitHub是一个面向开源及私有软件项目的托管平台，因为只支持Git作为唯一的版本库格式进行托管，故名GitHub。GitHub于2008年4月10日正式上线，除了Git代码仓库托管及基本的Web管理界面以外，还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱（报表）、代码片段分享（Gist）等功能。

Node.js

简单的说 Node.js 就是运行在服务端的 JavaScript。Node.js 是一个基于 Chrome JavaScript 运行时建立的一个平台。Node.js 是一个事件驱动 I/O 服务端 JavaScript 环境，基于 Google 的 V8 引擎，V8 引擎执行 Javascript 的速度非常快，性能非常好。

   工具准备

注：在下载nodejs与hexo后，如若在操作无误的情况下检验下载成功时报错，这时需要重启电脑。

下载node.js

请基于你自己的电脑操作系统类型，选择合适的版本下载

https://nodejs.org/en/download/

Node.js

下载完成后在vscode提供的powershell终端中输入一下指令($不需要输入哦,它代表你要输入的指令），来检验是否安装成功。（当然，如果没有下载，也可以使用win+R调用cmd终端

Powershell
1
2
3
4
5
6
$ node --version
v16.16.0

$ npm --version
npm WARN config global `--global`, `--local` are deprecated. Use `--location=global` instead.
8.15.1

如果出现以上信息，就代表已经安装成功啦！！！

下载Git

https://git-scm.com/

Git

注：下载后去所在文件夹点击安装！！

下载完成后在终端输入：

Powershell
1
2
3
$ git --version
v16.16.0
git version 2.38.0.windows.1

有如上显示就代表成功啦！

下载vscode

下面是vscode的官方链接

https://code.visualstudio.com/

Vscode

下载Hexo

下载之前，可以先去Hexo的官方文档熟悉了解操作，网址我贴在下面啦！！（自己看官方文档也是很重要的学习过程哦）

hexo官方文档：https://hexo.io/zh-cn/docs/

接下来，在你的终端中输入一下内容，快速下载hexo

Powershell
1
$ npm install -g hexo-cli

接下来就静待你的电脑安装hexo啦，等到安装结束，输入一下指令，来验证是否安装成功

Powershell
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$ hexo --version
hexo-cli: 4.3.0
os: win32 10.0.19044
node: 16.16.0
v8: 9.4.146.24-node.21
uv: 1.43.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.18.1
modules: 93
nghttp2: 1.47.0
napi: 8
llhttp: 6.0.7
openssl: 1.1.1q+quic
cldr: 40.0
icu: 70.1
tz: 2021a3
unicode: 14.0
ngtcp2: 0.1.0-DEV
nghttp3: 0.1.0-DEV

如若出现一下情况:

Powershell
1
2
hexo : 无法加载文件 C:\Users\username\AppData\Roaming\npm\hexo.ps1`，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 `about_Execution_Policies`。
所在位置 行:1 字符: 1

不要慌,在windows自带的搜索栏中搜索powershell，选择以管理员身份运行，输入以下代码：

Powershell
1
Set-ExecutionPolicy -ExecutionPolicy UNRESTRICTED

接下来会蹦出来一大串你看不懂的代码，不要慌张，无脑输入y,然后回车，这时回到vscode中输入hexo --version就不会报错啦

现在，你已经准备好所有工具啦，现在，就开始搭建我们的博客咯(*^▽^*)

创建博客本地文件夹

首先，在你电脑合适的位置创建一个文件夹，注意用英文，因为中文文件夹可能会引发兼容问题，所以先给自己的文件夹取个洋气的英文名。
创建完之后，就在你的终端输入如下命令：

Powershell
1
2
3
4
$ cd <your folder name>
$ hexo init
$ hexo g
$ hexo s

这时候你会发现，你创建的文件夹出现了很多其他文件，这时候就代表已经成功啦,你的终端会显示如下内容

Powershell
1
2
3
INFO  Validating config
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.

这些指令的意义后续我们会给出介绍，以后就会慢慢熟悉啦。点击上面的链接，如若能够跳转，就已经生成成功啦

注册github账户

这里网上已经有很多介绍啦，这里不再赘述，可以参考下面的教程

注：因为是境外网站，所以完成这一步需要一些魔法(*^▽^*)咳咳...

https://blog.csdn.net/xingkaifan/article/details/81105352

Github

在github中建立一个仓库

同上，不过多赘述啦

https://blog.csdn.net/weixin_43729943/article/details/103915046

Github

这边需要强调的是，因为我们最终目的是将我们的博客部署上去，所以我们创建仓库的名字一定要为 github用户名 .github.io

ssh连接

ssh是什么？

简单说，SSH是一种网络协议，用于计算机之间的加密登录。如果一个用户从本地计算机，使用SSH协议登录另一台远程计算机，我们就可以认为，这种登录是安全的，即使被中途截获，密码也不会泄露。最早的时候，互联网通信都是明文通信，一旦被截获，内容就暴露无疑。1995年，芬兰学者Tatu Ylonen设计了SSH协议，将登录信息全部加密，成为互联网安全的一个基本解决方案，迅速在全世界获得推广，目前已经成为Linux系统的标准配置。SSH只是一种协议，存在多种实现，既有商业实现，也有开源实现。

fromhttps://blog.csdn.net/u013452337/article/details/80847113

你并不需要十分了解，我们只需要知道我们需要用这个协议连接你和github
如果你之前没有用过的话，我们需要利用ssh-keygen的命令先生成属于你的密钥对

输入以下指令(因为github使用密钥时要求为rsa算法，所以接下来的密钥算法我们指定为rsa

Powershell
1
ssh-keygen -t rsa

为了方便，接下来可以一直回车，储存至默认位置，默认为空串，当然，你也可以指定（doge
当然，终端也会告诉你最终位置在哪

这时候，找到你的公钥，用记事本或者vscode打开，复制好那长长的一串，比如

1
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDjyY4QeOgoOZEPg1KhQmr2jgv6WeI0bykEvw3cH8I0gzEKtc+w2TK4XMFx9Y1lw7SoEZmK93Cro+76c/1V/yLbVtF14aPVjB6qo5f3sH5HwRscFysftY9j7R/oUvC1l+12Xe6AJWUwBefZk181ym0XAR6potdvcIqQ0eDYciu3On6W85tMG8iVzlsx9cMiDAgS8WtPrBAKgLPj4OqrVr3FJJW1W84myZezuXjSLdedV106BV3S3Uax/3DtaH3gQcxqt4Aor0ydr1P9BQsyL+SDuOM7f2mTlRmdwoI5zBNcs0z8+ECEJbh1MbkJCox7w4iwbx0NWoWRJgniva3bCw9QUr6iPUurI/2CIsAFiyw4Cbkj1aMaYTKi+uQfAJ3A6JUlWV/JlTQB7oRjXnbX/yqeR8H7IIF85AtkkLFwpB+t2nqnfb6TcWFNlDaSYB50RLcqP6IdjWYB+lhc5o/InkdCM70t75mMj/01o0X4p2XDSViZd2JSJYSlUVn5clYg3c0= 11691@DESKTOP-BKLSOI2

这里需要着重强调一下，这个公钥文件一定是.pub 同时生成的另一个文件一定不能泄露！！！非常重要
(据说大佬拿到这个就可以远程登陆你的电脑了，你也希望要留清白在人间吧（滑稽

接下来，打开你的github，打开设置，来到如下页面：

新建一个密钥，复制上述公钥，就可以啦

初始化你的git用户名和邮箱

小声bb：我自己搭建的时候就是因为我参考的教程没有提及这一点，导致我一度情绪爆发（doge

Powershell
1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

这里的"yourname""youremail"是你对应的Github用户名与邮箱

四.部署你的博客

打开你的配置文件：_config.yml

并在文件下方deploy补全如下

1
2
3
4
deploy:
  type: git
  repo: 你的仓库地址
  branch: main

输入以下指令：

Powershell
1
2
$ npm install hexo-deployer-git --save
$ hexo d

在完成后，打开你的浏览器，输入 你的名字 .github.io，如果能成功跳转那么恭喜你，你已经完成了博客的部署！！！

细心的你也许会发现，这时候你的博客已经发出了第一篇文章 Hollow World    (doge 好像万物的起点就是这个O(∩_∩)O

结尾

好啦，已经到深夜了，现在是2022/10/7 凌晨0:37 我终于完成了真正意义上的第一篇博客！！介绍完了搭建部署，那就下一篇讲讲怎么个性化你的博客吧（doge

晚安！