4、Hexo 框架入门：什么是 Hexo，它的核心概念（站点配置文件、主题、文章），以及安装 Node.js 和 Git

好，咱们正式开始搭建博客了。

这一章，我会带你认识 Hexo 这个框架。说白了，它就是帮你把写好的文章，自动生成一个漂亮静态网站的工具。我个人习惯把它叫做「博客生产线」——你只管写 Markdown，它负责生成 HTML。

4.1 什么是 Hexo？

Hexo 是一个基于 Node.js 的静态博客框架。嗯，这里有两个关键词：静态 和 框架。

静态 是什么意思？就是它生成的网页，没有后台数据库，没有动态交互。每个页面都是提前生成好的 HTML 文件。你想想看，这样访问速度能不快吗？而且部署起来特别简单，随便找个服务器或者托管平台就能跑。

框架 呢，就是它帮你把博客的骨架搭好了。你不需要从零写 HTML、CSS、JavaScript。只需要配置一下，写写文章，剩下的 Hexo 全包了。

核心特点：

  • 超快的生成速度——我实测过，几百篇文章也就几秒钟
  • 支持 Markdown 写作——你只需要关注内容
  • 丰富的主题生态——换皮肤跟换衣服一样简单
  • 一键部署——配合 Git，发布文章就是一条命令的事

我在项目中遇到过不少用 WordPress 的朋友，他们最头疼的就是服务器维护和数据库备份。Hexo 完全没这烦恼——生成的就是一堆静态文件，随便扔到哪都能跑。

4.2 Hexo 的三个核心概念

要玩转 Hexo，你只需要搞懂三个东西：站点配置文件、主题、文章。其他的都是锦上添花。

4.2.1 站点配置文件（_config.yml）

这是 Hexo 的大脑。所有全局设置都在这里。比如博客标题、作者信息、语言、URL 格式等等。

文件位置就在 Hexo 项目的根目录下，名字叫 _config.yml。注意，是下划线开头的。

# 站点配置示例
title: 我的技术博客
subtitle: 记录成长的点滴
description: 一个前端工程师的日常思考
author: 张三
language: zh-CN
timezone: Asia/Shanghai

我的经验： 修改配置文件后，一定要重启 Hexo 服务器才能生效。我曾经改了半天发现没变化，还以为出 bug 了……后来才反应过来没重启。

4.2.2 主题

主题就是博客的皮肤。Hexo 默认带了一个叫 landscape 的主题，说实话，挺丑的。不过别担心，社区里有成百上千个主题供你选择。

安装主题很简单：

# 在 Hexo 项目根目录下执行
git clone https://github.com/theme-next/hexo-theme-next themes/next

然后在 _config.yml 里改一行配置：

theme: next

搞定。刷新页面，你的博客就换了一身新衣服。

避坑指南： 我曾经直接修改主题文件来定制样式，结果主题一更新，所有修改都被覆盖了。正确的做法是使用主题的配置文件（一般在 themes/你的主题/_config.yml）或者创建自定义样式文件。

4.2.3 文章

文章是博客的灵魂。Hexo 使用 Markdown 格式来写文章。你只需要在 source/_posts 目录下创建 .md 文件就行。

每篇文章开头有一段「Front-matter」，用来定义文章的元数据：

---
title: 我的第一篇博客
date: 2024-01-15 14:30:00
tags: [Hexo, 入门]
categories: 技术教程
---
这里是文章正文，用 Markdown 写就行。

嗯，这里要注意：Front-matter 必须用三个短横线包裹，而且格式要严格。我刚开始写的时候，经常因为少了个空格导致文章发布失败。

4.3 安装 Node.js 和 Git

在安装 Hexo 之前，你得先把两个基础工具准备好：Node.js 和 Git。

4.3.1 安装 Node.js

Node.js 是 Hexo 的运行环境。没有它，Hexo 就跑不起来。

安装步骤：

  1. 打开 Node.js 官网（nodejs.org）
  2. 下载 LTS 版本（长期支持版，稳定）
  3. 双击安装，一路下一步就行

安装完成后，打开终端（Windows 用 PowerShell 或 CMD，Mac 用终端），验证一下：

node -v
# 输出类似 v18.16.0

npm -v
# 输出类似 9.5.1

看到版本号，说明安装成功了。

个人建议： 不要用最新版 Node.js，有时候会有兼容性问题。我一般用 LTS 版本，稳得很。

4.3.2 安装 Git

Git 是版本控制工具，也是 Hexo 部署博客的关键。你想想看，没有 Git，你怎么把博客文件传到服务器上？

安装步骤：

  1. 打开 Git 官网（git-scm.com）
  2. 下载对应系统的版本
  3. 安装时，建议勾选「Git Bash Here」和「Git GUI Here」

验证安装：

git --version
# 输出类似 git version 2.40.0

避坑指南： Windows 用户安装 Git 时，有个选项是「调整 PATH 环境变量」。一定要选「Git from the command line and also from 3rd-party software」。我刚开始选了默认选项，结果在 PowerShell 里找不到 git 命令，折腾了半天。

4.4 本章小结

好，我们来捋一捋这一章的核心内容：

概念 说明 关键点
Hexo 静态博客框架 基于 Node.js，生成纯静态 HTML
站点配置文件 _config.yml 全局设置，修改后需重启
主题 博客皮肤 不要直接修改主题文件
文章 Markdown 文件 注意 Front-matter 格式
Node.js 运行环境 安装 LTS 版本
Git 版本控制 安装时注意 PATH 选项

下一章，我们就要正式安装 Hexo 了。到时候你会看到，一条命令就能把博客框架搭起来，那种感觉还是挺爽的。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →