前言

有一天突然心血来潮，想搭建个博客。
但由于对博客一无所知，不知道如何下手，就到网上找了找教程。

刚开始用wordpress，搞半天终于把它弄到本地测试后，发现无从下手。
那时候的我连主题，文章，标签，评论等等的概念都没有，网上也没找到教程详细说这些的。
头脑一片空白，不知道怎么下手。
拷问了一下豆包，玩了几个功能后就更懵逼了。

于是我去b站看看有没有什么教程不那么吃操作的。
然后我就碰到了我心目中的神级博客教程 –【教程】Hexo个人博客搭建教程
这篇教程是b站up主bu明標記写的

整个教程非常简单易懂，也没有跳步，甚至他还专门写了篇这个教程的文章。
这是他的博客 小明的部落格
这是那篇教程 Hexo博客搭建教程

在此表示感谢，顺便写下搭建博客的步骤来纪念一下。

环境准备

Node.js 安装

[!NOTE]
Node.js 是 Hexo 的运行环境，必须先安装。

  1. 前往官网下载
  2. 默认选项安装
  3. 打开命令提示符(CMD)验证安装:
1
2
# 检查 Node.js 版本
node -v

返回版本信息则代表安装成功！

然后进行npm换源，运行

1
npm config set registry https://registry.npmmirror.com

无报错则安装完成！

Git 安装

  1. 下载 Git
  2. 安装时选择默认选项
  3. 验证安装:
1
git --version

安装 Hexo

Hexo官网
在所有应用中打开安装好的 Git Bash 运行

1
npm install -g hexo-cli

进行安装，之后运行

1
hexo -v

验证是否安装成功

GitHub 部署

注册后创建仓库名格式必须为：<用户名>.github.io
最好创建成私密库，因为后面配置会涉及到 API key
Git Bash 运行

1
2
git config --global user.name <你的用户名>
git config --global user.email <你的邮箱>

运行以下代码检查是否配置成功

1
git config -l

连接至 GitHub

接着运行

1
ssh-keygen -t rsa -C <你的邮箱>

直接按几次回车生成ssh密钥，用于此电脑连接至 GitHub

之后打开C盘用户文件夹下的.ssh的文件夹，用记事本打开 id_rsa.pub，复制里面的内容

然后点右上角头像 > Settings > SSH and GPG keys > New SSH key

Title随意，Key粘贴刚刚复制的密钥，之后点Add SSH key

运行以下代码测试连接，出现连接到账户至此环境部署完成

1
ssh -T git@github.com

新建 Hexo 项目

在桌面或者其他文件夹下右键，Open Git Bash here，运行

1
2
3
hexo init <项目名>
# 进入刚刚创建的项目
cd <项目名>

安装依赖

1
npm i

配置 Hexo

请参考官方配置文档

建议使用 Visual Studio Code 进行编辑（点这里进行下载）

安装后打开项目文件夹，点上方终端 > 新建终端，运行

1
hexo cl; hexo g; hexo s

CTRL+C 可结束运行，浏览器打开 http://localhost:4000/ 测试网站

安装主题

推荐主题 butterfly 安装及配置

请认真阅读配置文档

托管到 GitHub

安装 hexo-deployer-git

1
npm install hexo-deployer-git --save

修改 _config.yml 文件 deploy 部分

1
2
3
4
deploy:
  type: git
  repository: git@github.com:<用户名>/<用户名>.github.io.git
  branch: main

修改好配置后记得 CTRL+S 保存，运行以下命令，将代码部署到 GitHub

1
hexo cl; hexo g; hexo d

如果出现Deploy done，则说明部署成功

部署到 Vercel

官网地址

使用 GitHub 注册并登录，选择 Add New > Project

找到之前创建的库，点后面的 Import，直接点 Deploy 等待部署完成

之后到 Project 页面 > Domains 添加自己的域名，在域名管理页解析即可通过域名访问了！