Hexo+Github搭建博客教程

一、环境准备

1.Node.js安装

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

  1. 官网下载Node.js — Run JavaScript Everywhere

  2. 默认选项安装，一路点击“确认”

  3. win+R输入cmd，打开命令提示符验证安装：

    1
    2
    #检查 Node.js 版本
    node -v

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

    image-20251028104236478

然后进行npm换源，运行：

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

无报错则安装完成！

2.Git安装

  1. 下载Git:Git - Install

    选择[Git for Windows/x64 Setup]

  2. 安装时选择默认选项，一路选择回车

  3. 验证安装：

1
git --version

出现版本号则说明安装成功！

3.安装Hexo

  1. 在Windows搜索栏中搜索“Git Bash”，打开。

  2. 输入以下指令：

    1
    npm install -g hexo-cli

  3. 安装之后，运行下面指令：

    1
    hexo -v

    验证是否安装成功，当出现版本号则说明安装成功！

4.GitHub部署

  1. 在GitHub官网注册一个账号

  2. 注册后创建仓库，仓库名必须为：<用户名>.github.io

  3. Git Bash 运行

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

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

    1
    git config -l

image-20251028110643030

当出现user.name和user.email与之前输入的相同时，则配置成功！

5.连接至GitHub

运行：

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

按三次回车生成ssh密钥，用于连接到GitHub

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

然后点击GitHub账户头像 > Settings > SSH and GPG keys > New SSH key

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

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

1
ssh -T git@github.com

image-20251028115039314

说明连接成功！

二、新建Hexo项目

在想要创建的文件夹下，右键，Open Git Bash here，运行

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

安装依赖：

1
npm i

三、配置Hexo

推荐使用VS code 进行编辑

安装后使用VScode打开项目文件夹，点击查看>终端，运行下面指令：

1
hexo cl; hexo g; hexo s

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

四、安装主题

这里使用的是Butterfly主题

  1. 如果你沒有 pug 以及 stylus 的渲染器，请先下载安装：

    1
    npm install hexo-renderer-pug hexo-renderer-stylus --save

  2. 下载butterfly主题到项目文件夹下

    1
    git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

可能出现的问题：

fatal: unable to access ‘https://github.com/.../.git‘: Recv failure Connection was rese

解决办法：

在终端输入以下命令，设置 Git 使用本地代理：

1
2
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

7890是梯子的代理端口号。

设置完成后，可以通过以下命令检验是否设置成功：

1
git config --global -l

五、托管到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，则说明部署成功！

六、需要注意的问题

由于每个用户只能有一个GitHub页面，所以一定要设置成 用户名.github.io，不然虽然能创建成功，但是无法用这个打开页面。

一定保持自己的GitHub邮箱是公开的状态，不然会导致执行 hexo d命令时报错，导致无法部署到GitHub上去。