一、Hexo 简介

Hexo 是一个快速、简单且功能强大的静态博客框架，基于 Node.js 构建，适合用于搭建个人博客。

二、安装前准备

  • 操作系统要求

​Hexo 支持 macOS、Windows 和 Linux 系统。

  • 必备环境

​Node.js：需要安装 Node.js (建议使用 LTS 版本)，其自带 npm 包管理工具。

​Git：用于版本控制和托管静态文件。

​Github：需要注册一个Github账号。

  • 非必要

域名：最好是有一个自己的域名。当然，如果你不需要域名也可以使用GitHub的自带域名或者Cloudflare、Vercel、Netlify的域名。

Cloudflare：你需要注册一个Cloudflare帐号，这样你就可以将博客部署在CF的CDN里加速。（大陆IP访问速度一般）

Vercel：你需要注册一个Vercel帐号，这样你就可以将博客部署在Vercel的CDN里加速。（大陆IP访问阻断）

Netlify：你需要注册一个Netlify帐号，这样你就可以将博客部署在Netlify的CDN里加速。（大陆IP访问速度还行）

VSCode：这是一款轻量型的代码编辑器。（根据自己的使用习惯，也可以使用其他编辑器）

三、安装步骤

1. 安装 Node.js 和 Git

安装 Node.js

前往 Node.js 官网，下载并安装对应操作系统的 LTS 版本。（安装路径不要有中文）

打开终端验证安装是否成功：

node -v
npm -v

看到有版本信息，说明安装成功了。

安装 Git

前往 Git 官网，下载并安装 Git。（无脑下一步即可）

2.连接GitHub

打开Git终端，输入命令：

git config -l  //查看所有配置
git config --system --list //查看系统配置
git config --global --list //查看用户（全局）配置

配置用户名和邮箱

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

查看配置，看到变成自己GitHub的用户名和邮箱就说明配置好了。

配置公钥连接Github

执行以下命令生成ssh公钥，用于你的计算机连接Github。一路回车下去就可以了。

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

然后，打开C盘下用户文件夹下的 .ssh 的文件夹，会看到两个文件。

用记事本打开上述图片中的公钥 id_rsa.pub ，复制里面的内容，然后开始在github中配置ssh密钥。

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

测试连接，输入以下命令

ssh -T [email protected]

第一次连接会提示Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入yes即可。看到 access 说明链接成功了。

3.创建博客仓库

点击右上角的 + 按钮，选择 New repository ，创建一个<用户名>.github.io的仓库。

仓库名字的格式必须为：<用户名>.github.io (注意：前缀必须为用户名，此为预览博客需要，后期可修改仓库名)

可见性必须选择 Public 方便第一次部署检查问题，点击 Creat repository 进行创建即可

4. 安装 Hexo

在Git终端中运行以下命令，使用 npm 安装 Hexo：

npm install -g hexo-cli

验证安装是否成功：

hexo -v

看到版本信息就安装成功了

5. 初始化博客项目

选择一个文件夹作为你的博客根目录，比如 my-blog，进入该文件夹并初始化 Hexo 项目：

hexo init my-blog
cd my-blog
npm install 或 npm i

4. 启动本地服务器

初始化完成后，运行以下命令启动本地 Hexo 服务：

hexo clean && hexo server 或 hexo cl && hexo s

默认情况下，Hexo 会在 http://localhost:4000 提供预览，打开浏览器访问即可。

四、常用命令

命令作用
hexo generate 或 hexo g生成静态文件
hexo server 或 hexo s启动本地服务器
hexo clean 或 hexo cl清除缓存和生成的文件
hexo deploy 或 hexo d部署博客到远程服务器

五、部署到 GitHub Pages

1. 安装部署工具

运行以下命令安装 Hexo 的部署工具：

npm install hexo-deployer-git --save

2. 配置 _config.yml 文件

在博客根目录的 _config.yml 文件中，找到 deploy 部分，修改为：

deploy:
  type: git
  repo: https://github.com/你的用户名/你的仓库名.git
  branch: main

4. 部署博客

运行以下命令生成并部署博客：

hexo clean && hexo generate && hexo deploy
或
hexo cl && hexo g && hexo d

完成后，访问 https://你的用户名.github.io/ 即可看到你的博客。

六、补充

一切都完成之后，你可以将博客仓库设置为私人，这样会更安全，不过 https://你的用户名.github.io/ 这个域名就不能在访问了，必须要有自己的域名才能访问。

首先，进入博客仓库，点击 Settings

然后，拉到最下边找到 Danger Zone ，点击 Change visibility - Change to private

最后，需要确认三次

看到博客仓库旁有一把小锁，就成功该为私人仓库了

七、结语

通过以上步骤，您已经成功搭建了一个基于 Hexo 的静态博客，并部署到 GitHub Pages，让您的博客随时在线！Hexo 简单易用，适合初学者快速上手，同时支持高度自定义，满足进阶需求。搭配 GitHub Pages 和其他 CDN 服务（如 Cloudflare Pages），可以实现高效、零成本的个人博客搭建。

如果在搭建过程中遇到问题，不妨多查阅官方文档或相关教程，享受探索的过程，也欢迎在评论区留言！希望您的博客旅程愉快！ 😊