在GitHub上搭建Hexo环境(Windows)

🚨Hexo概述

Hexo 是一个快速、简洁且高效的静态博客框架，特别适合用来搭建个人博客或技术文档站点。它使用 Markdown 编写文章，通过渲染生成静态网页，最后部署到如 GitHub Pages、Vercel、Netlify 等平台上.其特点是使用 Node.js 编写，性能优秀，生成页面速度快，丰富的主题和插件系统，用户可自定义站点外观与功能可一键部署至 GitHub Pages、Vercel、Netlify 等平台有许多第三方主题、插件，文档齐全，是我们整理总结资料的好帮手

🔧 Hexo 的基本工作流程

1️⃣ 安装必备工具

在你的电脑上安装:
• Node.js (建议 LTS 版本)
• Git(例版本2.49.0.windows.1)
• 在GitHub 创建仓库，名字建议：你的用户名.github.io
（以我的为例：lchuanakane.github.io）

2️⃣ 初始化 Hexo 博客项目

打开终端安装 Hexo:

npm install -g hexo-cl

创建博客文件夹

hexo init myblog cd myblog

安装依赖

3️⃣ 本地启动博客

hexo s(server)

打开浏览器访问 http://localhost:4000，就能看到初始博客页面（在终端按住ctrl点击即可访问）

4️⃣ 生成静态文件

hexo g (generate)

生成的文件会放在 public/ 文件夹，里面会有你截图类似的结构(index.html、文章文件夹、css、js 等).

5️⃣ 部署到 GitHub Pages

⚠️安装部署插件：

npm install hexo-deployer-git --save

‼️‼️编辑 _config.yml（在博客根目录）：
当你完成 hexo init myblog 后，进入该文件夹：

cd C:\Users\你的用户名\myblog\

***deploy:***
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git
branch: main（或master）
首尾缩进空格
然后在终端输入:

hexo clean # 清理旧文件
hexo g（generate） # 重新生成网页
hexo d（deploy）# 部署到线上
hexo s（server）#本地预览，运行服务器\

6️⃣ 开启新文章

cd mylogs #切换到mylogs目录

hexo new “文章标题” #新建文档

再执行：

hexo g -d
你会发现此时在source/_posts/路径下生成一个文件例如：
source/_posts/文章标题.md

由于Hexo 是一个 静态博客生成器，它的工作方式就是把你写的 Markdown 文件（文章）+ 主题模板 → 生成 纯 HTML/CSS/JS 静态网页。所以你写完文章后，必须执行：

然后编辑 source/_posts/文章标题.md（建议用VScode打开编写文章），打开后你将看到这一段文字叫做 Front Matter，是 Hexo 用来识别文章信息的地方：

title：你的文章名
date：文档创建时间
tags：标签（可选）

✍️ 在 — 下面写你的正文内容，使用Markdown 的语法来写标题、列表、代码块、图片等等。

✅ 编辑完成后，查看文章：
hexo s 看看你的文章是否正常显示

7️⃣如何删除文章

非常简单，你只需要删除对应的 .md 文件即可。假设你要删除一篇名为 my-first-post.md的文章：
1. 定位文章文件夹
进入 Hexo 项目目录中的 source/_posts/ 文件夹：

cd your-blog-folder/source/_posts/

2. 删除文章 Markdown 文件

   
   del my-first-post.md

3. 重新生成静态文件
   删除文章后，要让网站更新，需要重新生成：

   
   hexo clean
   
   hexo g
   

4.预览本地网站确认删除效果
hexo s
然后打开浏览器访问 http://localhost:4000，确认文章已不再显示。

5.重新部署到线上

hexo d

📁Hexo 项目结构（文件夹类型）

source/_posts/
存放所有文章（Markdown 文件）
themes/
主题目录
public/
Hexo 生成的静态文件（可部署）
_config.yml
全局配置文件
scaffolds/
文章模板结构
📁想在hexo博客里插入音频，视频？
推荐上传到github里生成可应用链接
1下好插件
• 进入仓库 → 点击 Add file → Upload files → 选择你的 mp3 文件上传 → Commit。
3. 获取 Raw 链接
• 上传完成后，点击文件 → 点击 Raw 按钮 → 地址栏就是 mp3 的直接访问链接，例如：