Hexo+Github 搭建个人博客

搭建好后的第一篇文章自然是记录一下搭建过程，算是备忘录，同时把参考教程的链接一并列在这里，免得放在收藏夹里吃灰。

Hexo基于Node.js，搭建过程中还需要使用npm（Node.js自带）和git。

本次搭建基于以下环境：

主要参考：

Hexo与Github的快速博客建站教程 | MUG’s Blog

使用 Hexo+GitHub 搭建个人免费博客教程（小白向） - 知乎

安装

先安装前置应用 Node.js 和 Git，然后安装 Hexo

Node.js 和 Git 直接从官网上下载最新版即可。安装完成后，输入以下指令检查是否安装成功：

1
2
3

node - v #查看Node.js版本
npm -v  #查看npm版本
git --version #查看git版本

Node.js 安装完毕后正常情况下会带有 npm 软件包管理工具，打开 cmd (后续操作均在此进行）输入指令：

1	npm install -g hexo-cli #一键安装

不开代理下载得挺慢的。

输入如下指令，检查 Hexo 是否安装完成：

hexo -v

Hexo 安装完成后，选择博客的根目录 Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3

hexo init <folder> #初始化
cd <folder> #进入根目录
npm install #安装组件

输入如下指令，在本地初始预览：

hexo s

耗时之处

重点是仓库名需要按照用户名.github.io的格式进行填写。

参考：使用Hexo从0到1搭建个人博客详细教程（超详细，超简单）-腾讯云开发者社区-腾讯云

效果如下：

参考：不知道如何给GitHub Pages自定义域名？这就告诉你！ - 编程好6博客

Github端：

此外，还要在本地根目录下的source目录中创建CNAME文件，输入自己的域名（在VScode上展示）：

这里很关键，不走这步的话每次部署都要重新在github上绑定域名，很不方便。

注意：(相当重要)

url:后面有空格

branch选择main(默认分支）

输入以下命令：

npm install hexo-deployer-git --save  #安装部署工具
hexo clean  #清除public目录下的文件，即要上传到github上的文件
hexo g      #生成页面
hexo d		#启动预览