零基础用 Hexo + Matery 搭建博客｜Github Pages 免费部署教程

原创

已于 2025-05-14 16:04:49 修改 · 1.3k 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#github #hexo #matery #博客搭建

于 2025-05-14 15:57:06 首次发布

文章目录

一、Hexo

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

1.1 依赖

Node.js
根据下载指南下载安装适合当前系统的 Node.js 和 npm（Node.js 包管理器）。
安装完成后，打开终端，输入以下命令，检查是否安装成功：
```
# 需要大于10.13，建议使用 Node.js 12.0 及以上版本
node -v
npm -v
```
如果显示版本号，则说明安装成功。
Git
根据下载指南下载安装适合当前系统的 Git。
安装完成后，打开终端，输入以下命令，检查是否安装成功：
```
git --version
```
如果显示版本号，则说明安装成功。

1.2 快速使用

# 安装
npm install -g hexo-cli
# 初始化，<folder>输入博客名称，后续hexo会在<folder>中新建所需要的文件
hexo init <folder> && cd <folder>
npm install
# 生成静态文件
hexo generate
# 启动服务器
hexo server

现在，打开浏览器，访问 http://localhost:4000，即可看到博客本地已经搭建成功。

1.3 目录说明

初始化完成后，hexo 会在当前目录下生成一个名为 <folder> 的文件夹，该文件夹包含以下内容：

_config.yml：网站的配置文件，用于配置博客的标题、描述、作者等信息。
package.json：应用程序的信息。
scaffolds：存放博客文章的模板文件夹，用于生成博客文章的框架。
source：资源文件夹，是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 (下划线)的文件 / 文件夹 和 隐藏的文件 将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。新创建的帖子被保存到 source/_post 文件夹。
themes：主题文件夹，用于存放博客的主题。

1.4 命令说明

详细说明请参考指令

1.4.1 常规命令

命令	语法	描述	选项
init	`hexo init [folder]`	新建一个网站。如果没有设置`folder`，Hexo默认在目前的文件夹建立网站。	无
new	`hexo new [layout] <title>`	新建一篇文章。如果没有设置`layout`，默认使用`_config.yml`中的`default_layout`参数代替。使用布局 `draft` 来创建草稿。如果标题包含空格的话，请使用引号括起来。	`-p, --path`: 自定义文章路径 `-`