hexo个人博客搭建

HEXO个人博客搭建教程

前期准备

首先准备git、nodejs、hexo这三个工具

介绍

hexo

Hexo 是一个基于 Node.js 的静态博客框架,专为快速生成、部署博客网站设计。它通过将 Markdown 文件渲染成 HTML/CSS/JS 静态页面,配合主题模板实现个性化博客。

nodejs

提供 JavaScript 运行时环境,执行 Hexo 的生成、渲染和本地服务等核心功能。没有 Node.js,Hexo 无法运行任何命令(如生成页面或启动服务器)。

git

版本控制系统,用于部署博客到 GitHub Pages 或管理博客源码的变更历史。将生成的 public 目录推送到 GitHub 仓库,实现免费托管(非必须本地开发,但部署必需)。

Git的下载与安装

git下载

git:https://git-scm.com/download/win

image-20250728104659220

选择Git for Windows/x64 Setup

git安装

image-20250728104813801

无脑点击Next即可,注意不要安装到C盘。

Node.js的下载与安装

Node.js下载

Node.js:https://nodejs.org/en/download/

image-20250728102320048

.msi文件是 Microsoft Installer Package 的文件扩展名。它是一种安装包格式,专门用于在 Microsoft Windows 操作系统上安装、维护(修复、更新)和卸载软件。双击.msi文件,会触发 Windows Installer 服务即可进行文件的安装。

Node.js安装

image-20250728104357433

对新手来说全部点击下一步即可,切记不要安装到C盘。

image-20250728103453585

这个界面中Add to PATH选项是直接将程序的可执行文件路径添加到操作系统的 PATH 环境变量中。用户能在命令行(终端或命令提示符)的任意位置,能够直接通过程序名称调用该程序,无需输入完整路径。

image-20250728104228884

安装完成后打开CMD输入node -v如果弹出node的安装版本则说明安装成功。

HEXO下载

使用管理员身份打开CMD命令提示符输入命令

npm install hexo-cli -g

image-20250728105320518

运行完成后输入命令hexo -v查看是否安装完成

image-20250728105538226

Hexo

创建一个文件夹,右键选择Open git bash here,打开git再输入

hexo init blog

image-20250728112247614

在./blog路径下面打开git bash输入

npm install

image-20250728112348103

接着输入hexo g查看依赖

image-20250728135906477

最后使用hexo s启动博客

image-20250728135916623

在浏览器输入http://localhost:4000/登录本地博客验证

image-20250728140115144

创建仓库

打开github点击左上角的按钮创建一个自己的的仓库

image-20250728134445039

在Repository name输入自己的名字.github.io,勾选Public和Add a README file,再点击右下角的create repository即可

image-20250728114841375

创建好仓库后如下

image-20250728114927269

生成SSH Keys

右键打开git bash,输入下面代码生成key,可以看到密钥的存放地点在C盘的用户目录的.ssh目录下

ssh-keygen -t rsa -C "2912043121@qq.com"

image-20250728151131458

打开id_rsa.pub文件复制里面的密钥

image-20250728151606023

配置SSH Keys

在github中点击自己的头像,选择setting(设置)

image-20250728151750180

选择新建New SSH key

image-20250728151859518

然后将刚才复制好的rsa密钥粘贴进下面的key输入框中即可

image-20250728152304305

接下来测试ssh连接,在git bash中输入

ssh —T git@github.com		#接着在询问时输入yes

image-20250728153502891

上线博客

找到blog目录下的_config.yml文件并进行编辑

image-20250728153801343

直接划到文件末尾

image-20250728154003026

修改描述,type类型为git、repository填上自己刚刚创建的github仓库的地址、branch选择main

image-20250728161435367

接着在blog文件夹下打开git bash

输入

npm install hexo-deployer-git --save		#安装自动部署发布工具

image-20250728154433934

安装完工具后,输入

hexo g		#生成静态文件
hexo d #将静态文件上传到github

第一次使用git时会提示需要配置github的邮箱和名字

image-20250728155016670

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

配置完成后重新运行上面的hexo命令即可

发布文章

在blog文件夹下运行git bash

hexo new “文章名”

image-20250728160201189

简单创建文章并发布

登录测试

在浏览器输入https://[自己的名字].github.io

image-20250728163605050

Author: wickt42
Link: http://example.com/2025/07/28/hexo个人博客搭建/
Copyright Notice: All articles in this blog are licensed under CC BY-NC-SA 4.0 unless stating additionally.