Hexo 简介
Hexo 是什么
Hexo 是一个快速、简洁且强大的静态博客框架，基于 Node.js 驱动。你只需使用 Markdown 写作，Hexo 就会在几秒内生成纯静态的 HTML 页面，无需数据库、无需 PHP 等后端环境，任何静态托管（GitHub Pages、Vercel、Nginx、对象存储等）都能直接承载。
相比动态博客系统，Hexo 的优势：
- 快：静态页面，无需服务端渲染，CDN 加速友好
- 简单：Markdown 写作，Git 版本管理，一条命令部署
- 强大：海量插件与主题生态（本教程即基于深度定制的 matery 主题）
- 安全：无数据库、无运行时漏洞面，天然抗攻击
本博客（夜法之书）即基于 Hexo 8.1.2 + matery 主题构建，生产环境由 Vercel 托管。
环境要求
| 组件 | 版本要求 | 说明 |
|---|---|---|
| Node.js | >= 20 | Hexo 8.x 运行环境（本站开发使用 LTS 版本，engines 要求 >= 20.19.0） |
| npm | >= 10 | 随 Node.js 安装，用于安装 Hexo 与插件 |
| Git | 任意现代版本 | 拉取主题、部署到 Git 托管平台 |
验证环境：
node -v # v20.x 之类
npm -v # 10.x 之类常用命令
| 命令 | 作用 |
|---|---|
hexo init [folder] | 新建站点。等价于克隆 hexo-starter 并安装依赖 |
hexo new post <标题> | 新建文章到 source/_posts/（标题含空格需加引号） |
hexo new page <名称> | 新建独立页面（如 about、tags） |
hexo new draft <标题> | 新建草稿到 source/_drafts/ |
hexo publish <标题> | 将草稿发布为正式文章 |
hexo generate | 生成静态文件到 public/（-w 监视改动，-d 生成后部署） |
hexo server | 启动本地预览，默认 http://localhost:4000/（-p 指定端口） |
hexo deploy | 部署网站（推送至配置的 Git 仓库，-g 部署前先生成） |
hexo clean | 清除缓存（db.json）与生成目录（public），改配置/插件后建议执行 |
hexo --safe | 安全模式，不加载插件与脚本，排查插件冲突时使用 |
hexo server --draft | 预览时显示草稿 |
hexo version | 查看 Hexo 版本 |
常用组合（本项目 package.json 脚本）：
npm run build # hexo generate（另含 pagefind 搜索索引）
npm run clean # hexo clean
npm run server # hexo server
npm run deploy # hexo deploy工作流程
写作（Markdown） → 生成（hexo generate） → 部署（hexo deploy）- 写作：
hexo new post "文章标题"创建文章，用 Markdown 编辑source/_posts/下的文件 - 预览：
hexo server在本地检查效果（默认localhost:4000） - 生成：
hexo generate将文章渲染为public/静态文件 - 部署：
hexo deploy推送至 Git 仓库；或推到 GitHub 由 Vercel 等平台自动构建
提示：修改
_config.yml或主题配置后，务必先hexo clean再hexo generate，否则可能命中缓存导致改动不生效。