基于 Node.js 的 Hexo 静态博客搭建与 GitHub Pages 部署指南
Hexo 框架概述
Hexo 是一个基于 Node.js 构建的高效静态站点生成器。与传统的动态内容管理系统不同，Hexo 的核心工作流是在本地环境中将 Markdown 格式的文档编译为纯静态的 HTML 文件，随后将这些资源部署到 Web 服务器或静态托管平台上。这种架构不仅大幅降低了服务器的计算资源消耗，还显著提升了页面的加载速度和抗并发能力。
环境准备与安装
在开始构建之前，请确保您的开发环境中已安装最新 LTS 版本的 Node.js。Hexo 的命令行脚手架工具需要通过 npm 进行全局安装：
npm install -g hexo-cli为了提升依赖包的下载速度，建议将 npm 的注册表源切换为国内最新的镜像源：
npm config set registry https://registry.npmmirror.com项目初始化与本地调试
安装完成后，使用 init 命令初始化一个新的博客项目目录，并安装基础依赖：
hexo init my_hexo_site
cd my_hexo_site
npm install进入项目目录后，创建您的第一篇 Markdown 文章：
hexo new "getting-started-with-hexo"启动本地开发服务器以预览博客效果：
hexo server服务启动后，在浏览器中访问 http://localhost:4000 即可查看实时渲染的博客页面。
静态资源编译
当文章编写完成并确认排版无误后，需要将 Markdown 文件编译为浏览器可直接解析的 HTML 静态文件。执行以下生成命令：
hexo generate编译完成后，所有的静态网页、样式表及脚本文件都会被自动输出到项目根目录下的 public 文件夹中。
主题配置与定制
Hexo 默认搭载了 landscape 主题，但社区提供了大量优秀的第三方主题。以广受欢迎的 NexT 主题为例，您可以将其克隆到 themes 目录下：
git clone https://github.com/next-theme/hexo-theme-next themes/next接着，打开项目根目录下的 _config.yml 核心配置文件，找到 theme 字段并将其修改为 next：
# _config.yml
theme: next修改配置后，重启本地服务器即可预览新主题的视觉效果。
部署策略
方案一：自有服务器部署
如果您拥有独立的云服务器和域名，只需将 public 目录下的所有文件通过 FTP 或 SCP 上传至服务器的 Web 根目录，并配置 Nginx 进行静态资源代理即可。
方案二：GitHub Pages 免费托管
对于没有独立服务器的开发者，GitHub Pages 是极佳的免费静态托管方案。
- 登录 GitHub，创建一个新的公共仓库。
- 关键步骤：仓库名称必须严格遵循
<您的GitHub用户名>.github.io的命名规范。例如，如果您的用户名是dev_user，则仓库名必须为dev_user.github.io。 - 在本地项目中安装 Hexo 的 Git 自动化部署插件：
npm install hexo-deployer-git --save- 在
_config.yml文件末尾添加部署配置：
deploy:
type: git
repo: https://github.com/dev_user/dev_user.github.io.git
branch: main- 执行一键部署命令，Hexo 会自动清理缓存、生成静态文件并将
public目录的内容推送到远程仓库：
hexo clean && hexo generate && hexo deploy推送完成后，等待 GitHub 完成页面构建，随后即可通过 https://<您的GitHub用户名>.github.io 访问您的个人博客。
