1. 前期准备工作

  1. Node ( 必备 )
  2. Git ( 必备 )
  3. VSCode ( 可选 )
  4. 域名,建议配置一个域名以避免被防火墙阻挡,推荐购买链接: https://spaceship.sjv.io/limin
  5. 配置 Cloudflare,托管域名: 托管教程
  6. 创建免费图床: 图床搭建教程
  7. 注册cloudflare怕被扣费,推荐用myfine有50张虚拟卡(需要护照),教程链接: 注册教程
  8. Hexo官方主题展示: 点击跳转

2.1. 安装 Node

  1. 从 Node 官网 下载适合自己系统的版本。
  2. 完成安装,Windows电脑建议使用默认目录 C:/Program Files/nodejs/ ,苹果电脑无所谓。
  3. 验证安装成功,在命令行中输入 node -v 检查版本信息。
    示例图片
  4. 苹果用户可通过右键文件夹,选择“服务”,新建终端窗口以便操作。

2.2. 安装 Git

  1. 从 Git 官网 下载适配的 Git 版本。
    示例图片
  2. Windows 用户可使用默认目录安装 Git,Mac 用户则按提示在终端操作。
  3. 验证安装完毕后,Windows 用户会在开始菜单中看到 Git Bash 等应用。

2. 配置 Git 密钥并连接至 Github

常用 Git 命令:

bashgit config -l

git config --system --list

git config --global --list

3.1. 配置用户名和邮箱

bashgit config --global user.name "你的用户名"

git config --global user.email "你的邮箱"

通过 git config -l 验证是否成功。
abd

3.2. 配置公钥连接 Github

  1. 生成 SSH 公钥:
bashssh-keygen -t rsa -C "你的邮箱"

一路回车生成密钥,进入 .ssh 文件夹复制 id_rsa.pub 公钥内容,配置到 Github 的 SSH 设置中。
abm

3.在苹果电脑上,如果你知道文件的路径,可以通过以下几种方式快速找到文件:

打开Finder。
按下 Command + Shift + G,在弹出的对话框中输入文件路径,然后按 Enter。这样可以直接跳转到该路径下的文件。
abm

在windows电脑上:

打开C盘下用户文件夹下的.ssh的文件夹,会看到以下文件
id_rsa 私钥
id_rsa.pub 公钥

找到公钥匙,并复制,打开GitHub开始配置
abm

  1. 将 SSH KEY 配置到 GitHub
    进入github,点击右上角头像 选择settings,进入设置页后选择 SSH and GPG keys,名字随便起,公钥填到Key那一栏。
    abm

abm

  1. 测试连接:
bashssh -T git@github.com

第一次连接会提示Are you sure you want to continue connecting (yes/no/[fingerprint])?,输入yes即可
abm

3.3. 创建 GitHub.io 仓库

  1. 点击右上角的 + 按钮,选择新建仓库,命名格式为 <用户名>.github.io ,(注意:前缀必须为用户名)选择公开 Public 。
  2. 点击 Creat repository 进行创建即可。
    abm

abm

4. 初始化 Hexo 博客

  1. 创建文件夹保存博客源码:

苹果用户随意创建好文件夹后,在文件夹右击,选择“服务”选择“新建终端窗口以便操作”

Windows用户可以(例如 D:/Hexo-Blog),在该文件夹内启动 Git Bash 或终端。

  1. 安装 Hexo:
bashnpm install -g hexo-cli && hexo -v

出现此页面代表安装成功
abm

  1. 初始化 Hexo 项目安装依赖:
bashhexo init blog-demo

cd blog-demo

npm i

abm

现在你的文件夹会有这些内容
abm

  1. 启动项目并验证:
bashhexo cl && hexo s

在浏览器中访问 http://localhost:4000/ 以查看效果。

abm

5. 将静态博客挂载到 GitHub Pages

  1. 修改 _config.yml 文件,配置 repository 为你的 GitHub 地址,分支改为 main :
yamldeploy:

  type: git

  repository: git@github.com:你的用户名/你的用户名.github.io.git

  branch: main
  1. 安装 hexo-deployer-git :
bashnpm install hexo-deployer-git --save
  1. 部署到 GitHub:
bash// Git BASH终端

hexo clean && hexo generate && hexo deploy  

// 或者

// VSCODE终端

hexo cl; hexo g; hexo d

访问 https://<用户名>.github.io/ 以查看博客。

6. 将静态博客挂载到 Cloudflare Pages

  1. 通过 Cloudflare Pages 连接 Git 仓库。
  2. 登录 GitHub,点击保存并部署。
  3. 部署成功后,访问 Cloudflare 提供的链接。

如有自定义域名,可以在 Cloudflare Pages 中绑定。没有建议去申请,这样博客就不被墙了。

如何使用

新建一篇博文

bashhexo new 这是一篇新的博文

编辑 _posts 文件夹中的新建文章,使用 Markdown 语法编写内容。

本地预览

bashhexo cl && hexo s

推送到 GitHub

bashhexo cl && hexo g && hexo d

进阶教程预告

接下来会介绍 Hexo 主题美化 文章写作 赶紧订阅我吧!

解决 VSCODE 报错

如果首次执行 VSCODE 终端出现报错,可以使用管理员身份打开 PowerShell,并执行以下命令:

bashSet-ExecutionPolicy RemoteSigned