本地安装Hexo博客

摘要：本文主要介绍如何下载和安装Hexo。

1 简介

Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

官网：https://hexo.io/zh-cn

2 环境

2.1 安装Git

由于初始化博客目录需要Git支持，并且Hexo的某些命令需要在bash命令行中执行，因此需要安装Git工具。

下载方式：

• 方式一：官网下载最新版：https://git-scm.com
• 方式二：通过GitHub选择2.37.3版本下载，历史版本下载地址：v2.37.3.windows.1/
• 方式三：通过淘宝镜像下载，比GitHub访问速度快：v2.37.3.windows.1/

如果不太了解Git工具，可以使用默认设置安装。

安装结束后，右键选择Git Bash Here进入bash命令行：

输入git --version命令查看Git的安装版本：

需要注意的是，默认安装的2.37.3版本在初始化本地Git项目的时候，默认创建的分支还是master分支，可以在安装的时候自定义：

2.2 安装Node

Hexo基于Node，搭建过程中还需要使用NPM（Node包管理工具，安装Node时默认安装）。

下载方式：

• 方式一：官网下载最新版：https://nodejs.org/en
• 方式二：本文使用的版本不是最新版，是18.14.0版本。下载地址：v18.14.0/

使用默认配置安装结束后，打开cmd命令行，输入npm -v命令和node -v命令查询NPM版本和Node版本：

NPM是包管理工具，通过命令将安装包使用的源设置为淘宝镜像，速度会快一些：

1

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

使用命令查看安装使用的源：

1

npm config get registry

2.3 安装Hexo

在cmd命令行中使用NPM安装Hexo：

1

npm install hexo-cli -g

安装结束后，使用hexo -v命令查看Hexo版本：

3 使用

3.1 初始化博客目录

在电脑中新建博客目录，右键进入bash命令行，使用命令初始化博客目录：

1

hexo init

结果如下：

3.2 博客预览

使用hexo generate命令生成博客内容，也可以简写为hexo g命令。

结果如下：

使用hexo server命令启动本地预览，也可以简写为hexo s命令。

结果如下：

根据提示，在浏览器输入地址访问博客：http://localhost:4000/

可以看到博客的默认界面：

可以使用Ctrl+C命令停止博客。

3.3 新建文章

使用命令创建文章：

1

hexo new test

执行后创建标题为test的文章，在博客名录下的source目录中的_posts目录中会自动新增对应的Markdown文件：

也可以指定文字标题和文章路径：

1

hexo new post test -p demo/test

可以通过文本编辑器修改文章，保存后在本地预览：

1

hexo clean && hexo s

3.4 站点设置

修改博客目录下的_config.yml配置文件，修改的Site配置项，修改站点属性。

4 分类和标签

4.1 分类

进入博客目录，打开bash命令行，添加分类页：

1

hexo new page categories

打开sources/categories/index.md文件，增加分类配置：

1
2
3
4
5

---
title: 所有分类
date: 2024-02-25 21:45:11
type: "categories"
---

使用分类：

1
2
3

---
categories: 
---

4.2 标签

进入博客目录，打开bash命令行，添加标签页：

1

hexo new page tags

打开sources/tags/index.md文件，增加标签配置：

1
2
3
4
5

---
title: 所有标签
date: 2024-02-25 21:53:29
type: "tags"
---

使用标签：

1
2
3

---
tags: []
---