从零开始：我的 Hexo 博客搭建之旅

---

Hello大家好，这里是小丑爱。

在信息碎片化的时代，搭建一个独立博客是我沉淀思考、拒绝直接复制粘贴的阵地。今天咱们直接上硬核干货，手把手带你完成从环境搭建到公式渲染的全过程。

---

🛠 第一步：地基建设 (环境准备)

在开始之前，请确保你的电脑已经安装了 Node.js (建议 LTS 版本) 和 Git。

1. 安装 Hexo 框架： 打开终端，输入以下命令全局安装：

   npm install -g hexo-cli

2. 初始化项目：

​ 找一个你喜欢的文件夹（例如 blog），执行：

Bash

hexo init blog
cd blog
npm install

​ 至此，你的博客本地雏形已经搭建完成。

---

🎨 第二步：为博客注入灵魂 (Fluid 主题)

我选择 Fluid 是因为它现代优雅的 Material Design 风格以及极其详尽的配置文档。

1. 安装主题：

   在博客根目录下执行：

   Bash

   npm install --save hexo-theme-fluid

2. 指定主题：

   打开根目录下的 _config.yml（站点配置文件），修改：

   YAML

   theme: fluid

3. 创建关于页（Fluid 要求）：

   Bash

   hexo new page about

   然后在 source/about/index.md 中编辑你的个人简介。

---

🔥 第三步：核心攻克 (Pandoc 与 LaTeX)

这是搭建过程中最难的一关。Hexo 默认的 Marked 引擎经常会把 LaTeX 的下划线 _ 误识别为 HTML 斜体，导致公式“炸裂”。我选择了专业级的 Pandoc 方案。

1. 卸载默认引擎

Bash

npm uninstall hexo-renderer-marked --save

2. 安装 Pandoc 渲染器

首先确保你电脑系统里已经安装了 Pandoc 软件（建议 3.8.3+），然后在博客目录下安装插件：

Bash

npm install hexo-renderer-pandoc --save

3. 开启数学公式

在 _config.fluid.yml（主题配置文件）中，找到 post 部分，确保开启：

YAML

post:
  math:
    enable: true
    specific: true # 仅在 md 头部标记 math: true 的文章中加载，提高渲染效率

4. 效果展示

现在你可以随心所欲书写公式了，比如求根公式：

$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

---

🚀 第四步：同步至全球 (GitHub Pages)

通过一行命令，即可将本地思考同步至全球。

1. 安装部署插件：

   Bash

   npm install hexo-deployer-git --save

2. 配置 GitHub 仓库：

   在根目录 _config.yml 末尾修改：

   YAML

   deploy:
     type: git
     repo: git@github.com:你的用户名/你的用户名.github.io.git
     branch: main

3. 一键部署：

   Bash

   hexo clean && hexo g && hexo d

---

📝 写在最后

博客搭建不是终点，持续的思考和输出才是。希望这篇实战指南能帮你少走弯路。

这里是小丑爱，我们下次见！