个人博客搭建全记录01-基于Hexo的初步搭建

SEAlencehe2025-12-132026-02-01

笔者基于Hexo框架搭建——这款基于 Node.js 的静态博客框架，以轻量高效、支持 Markdown、主题生态丰富等优势深受开发者喜爱

一、项目初始化

1.全局安装 hexo

pnpm i hexo-cli -g

2.创建项目文件夹 my_blog，在文件夹内运行初始化

hexo init

3.安装依赖

pnpm i

4.这时候就可以启动服务查看效果 localhost:4000

hexo server

二、博客个性化

hexo 有很多很漂亮的主题，笔者这里选择的是闪烁之狐

github

demo

doc

1.下载主题

在项目根目录运行

git clone https://github.com/blinkfox/hexo-theme-matery.git

2.把下载下来的文件夹放到`themes`文件夹下

3.修改 Hexo 根目录下的 `_config.yml` 的 `theme` 的值：

theme: hexo-theme-matery

4.清理缓存

hexo clean

5.刷新页面，就可以看到已经成功的更换主题了

三、站点配置

基础站点配置

根目录_config.yml中，以下是必改项示例（完整配置参考主题官方文档）

# 网站基本信息
title: 你的博客标题 # 浏览器标签页标题
subtitle: 分享技术与生活 # 博客副标题（通常显示在首页顶部）
description: 记录成长的技术博客 # 用于搜索引擎优化
author: 你的名字 # 文章作者署名
language: zh-CN # 网站语言（中文）
timezone: Asia/Shanghai # 时区

# 网址配置（部署后需修改为你的域名）
url: http://localhost:4000
permalink: :year/:month/:day/:title/ # 文章链接格式

其他配置

具体可参考主题的 doc 详细配置

鸣谢

感谢青花鱼提供的技术答疑