Hexo 相关知识

一.什么是Hexo？

核心定义：一个快速、简洁且高效的静态博客框架

工作原理：使用 Markdown（或其他标记语言）编写内容，通过 Hexo 引擎解析，结合主题模板，生成静态 HTML、CSS、JavaScript 文件。

技术栈：基于 Node.js 运行

二.如何安装和部署？

安装

1. 前提：安装 Node.js (>= 12.0) 和 Git。
2. 全局安装 Hexo CLI: npm install -g hexo-cli
3. 初始化项目：hexo init folder_name
4. 进入项目目录：cd folder_name
5. 安装依赖：npm install
6. 本地预览：hexo server (hexo s)

部署

1. 配置 _config.yml： 设置 url, root, 最重要的是 deploy 部分（配置类型如 git, 仓库地址、分支）。
2. 安装部署插件： 常用 hexo-deployer-git: npm install hexo-deployer-git —save
3. 生成 & 部署： hexo clean && hexo deploy (hexo clean && hexo d)

三.目录构成

• _config.yml (站点配置文件)： 全局配置（标题、描述、URL、主题、部署设置等）。功能： 控制整个站点的行为。部署： 随源码一起。
• source/ 目录： 存放用户内容（Markdown 文件 _posts/, _drafts/，图片、CSS/JS 资源等）。功能： 内容核心。部署： 源文件随源码；生成的静态资源在 public/。
• themes/ 目录： 存放主题。功能： 定义网站外观、布局和功能扩展点。部署： 主题作为项目子模块或直接复制，随源码一起；主题的静态文件在构建时也会被处理复制到 public/。
• scaffolds/ 目录： 模板文件。功能： 定义 hexo new 命令生成新文章、页面等的初始结构。部署： 仅开发时使用，不部署。
• public/ 目录 (生成)： 存放最终生成的静态网站文件。功能： 部署的内容。部署： 仅 这个目录的内容需要部署到服务器/CDN。通常由部署命令自动完成。
• node_modules/ 目录： 存放 npm 依赖（Hexo 核心、插件、主题依赖）。功能： 运行和构建所需。部署： 绝不 部署此目录。由 .gitignore 排除。

四.Hexo 极简命令速查表

场景	完整命令	简写命令	作用说明
写新文章	hexo new "标题"	hexo n	在 source/_posts 下创建文章
本地预览	hexo server	hexo s	启动本地服务器（默认4000端口）
生成静态页	hexo generate	hexo g	生成静态HTML到 public 目录
部署到网站	hexo deploy	hexo d	发布到GitHub Pages等托管平台
清理缓存	hexo clean	无简写	清除缓存和旧生成文件