参考教程:

【零成本】Hexo个人博客搭建教程 | 无需服务器_哔哩哔哩_bilibili

如何用Hexo搭建个人博客? (fiveth.cc)

一、工具

1.Github账号

首先需要有一个Github账号,没有的在Github官网上注册一个GitHub · Build and ship software on a single, collaborative platform · GitHub

(ps:Github有时候可能会打不开或者加载速度慢,可以用Watt Toolkit加速)

2.NodeJS

NodeJS官方下载链接Node.js — 下载 Node.js® (nodejs.org)

NodeJS的安装过程可以查看这篇文章Node.js安装及环境配置之Windows篇 - 刘奇云 - 博客园 (cnblogs.com),最好是安装最新版的NodeJS

3.Git

Git官方下载链接Git - Downloads (git-scm.com)

后续我们对hexo进行部署需要用到Git,安装过程可以参考这篇Windows系统Git安装教程(详解Git安装过程) - 学为所用 - 博客园 (cnblogs.com),同样也是安装最新版的

4.Hexo

在安装hexo之前,我们先检测一下是否全部下载安装成功

管理员身份运行cmd,输入以下指令

1
2
3
node -v
npm -v #这是nodejs自带的
git -v

若正常输出版本号则代表安装成功

接下来我们要下载安装hexo,在cmd中输入

1
npm install hexo-cli g

如果无法安装,则改为输入

1
npx install hexo

后续若还有npm报错的,一律改为npx

至此,已经完成了工具的准备

二、搭建仓库

接下来准备在Github中搭建用于存放静态页面的仓库

首先登录Github,在右上角点击加号,选择New repository

仓库名输入“用户名.github.io”

勾选Public,勾选add a readme file,然后Create创建

三、生成ssh key

电脑任意位置右键空白处,选择git bash here,输入

1
ssh-keygen -t rsa -C "你的邮箱"

敲4下enter

然后进入C:\Users\用户名,找到.ssh文件夹

:::color3
注意,用户文件夹名称必须是英文,不能包含中文!!

若用户文件夹名为中文,删除.ssh文件夹,修改文件夹名后再重复上面生成.ssh的步骤

具体修改用户文件夹名称的方法笔者没找到,更简便的方法是新建一个用户

:::

然后用记事本打开id_rsa.pub文件,全选文本内容复制

然后打开github,右上角点击个人头像,选择“Settings”

在左侧边栏找到“SSH and GPG keys”,新建一个ssh key,名称随意,在“Key”栏粘贴刚刚的文本内容

然后点击“Add SSH key”

接着我们测试一下是否创建成功

如果有开Watt Toolkit一类加速器先关闭,避免报错

在git bash中输入

1
ssh -t git@github.com

四、本地生成Blog内容

自选位置新建Blog文件夹,在文件夹中打开git bash,输入

1
hexo init

如果报错command not found,则改为输入

1
npx hexo init

然后输入

1
hexo install

接着依次输入

1
2
hexo g
hexo s

现在我们就可以按住Ctrl键单击输出的链接访问我们的本地服务器了

关闭网站后记得Ctrl+C关闭本地服务器

五、上线Blog

进入Blog文件夹,用记事本打开_config_yml

拉到最底部,把deploy后面的全部删掉,复制粘贴这段

1
2
3
type: git
repository:
branch: main

:::color3
注意缩进格式,每行前面两个空格不要删,冒号后的一个空格也不要删

:::

打开github,打开我们新建的仓库“用户名.github.io”,右上角点击Code,复制https链接

将其粘贴至我们的_config.yml文件中repository: 后面(冒号后面的空格不要删!!!

保存后退出,在Blog文件夹打开git bash,输入以下指令安装自动部署发布工具

1
npm install hexo-deployer-git --save

然后依次输入

1
2
hexo g
hexo d

:::color3
如果是第一次使用git的话需要配置

git config –global user.email “你的邮箱”
git config –global user.name “用户名”

配置完后再hexo d上传

在跳出来的窗口进行登录

:::

至此,个人Blog已初步搭建完成

在浏览器内输入“用户名.github.io”,就可以访问我们的个人Blog主页了!