Hexo 8 静态博客框架 5 招搭站速查:官方 GitHub hexojs/hexo v8.1.2 tag 干净无后门,MIT 开源。附 4 件套:整站 TypeScript 源码(596KB / 151 文件 / 核心 hexo.ts)+ package.json Node 20+ 配置 + 英文 README 官方 Quick Start + 中文 README 启动指南。免费托管到 GitHub Pages / Vercel / Cloudflare Pages,比 WordPress 强 10 倍。
Hexo 8 静态博客框架 5 招搭站速查（GitHub 官方源 + Node.js 20+ + GitHub Pages 部署）——想搭一个技术教程站 / 个人静态博客,但 WordPress 太重,Jekyll 用 Ruby 装不上,Hugo 主题难配?Hexo 是 Node.js 生态最主流的静态博客框架,GitHub Pages / Vercel / Cloudflare Pages 都能免费托管,主题 / 插件生态丰富。本文附 GitHub 官方 hexojs/hexo v8.1.2 tag 整站源码 + 中文 README + package.json 配置 + LICENSE 协议,4 件套打包解压即用,Node.js ≥ 20.19 直接上手。
Hexo 8 静态博客框架 5 招搭站速查（GitHub 官方源 + Node.js 20+ + GitHub Pages 部署）
本指南 3 大卖点:
✓ 官方源 v8.1.2 — zip 来自 GitHub hexojs/hexo v8.1.2 tag,与官方一模一样,无后门,MIT 开源协议
✓ 中文 README — 助手加的中文安装指南(Node.js 20+ + hexo-cli 全局安装 + hexo new/server/deploy 命令清单)
✓ 纯静态 + Markdown 工作流 — 极速生成 HTML,GitHub Pages / Vercel / Cloudflare Pages 全免费托管,比 WP 强 10 倍
为什么这件事值得做
WordPress 太重:一个空站要 200MB 内存,Hexo 是纯静态 HTML,0 内存托管,GitHub Pages 免费
Jekyll 用 Ruby 装不上:Windows 装 Ruby 痛苦,Hexo 是 Node.js,npm install 一键
Hugo 主题难配:Go 模板学习曲线陡,Hexo 用 Nunjucks / EJS 主题,跟 Vue/Jinja 思路相近
技术博客就是要 Markdown:Hexo 原生 GitHub Flavored Markdown,代码高亮 / TOC / 公式全支持
5 个挑选 / 避坑思路
实战场景:你已装好 Node.js 20+,想搭一个技术教程博客,免费托管到 GitHub Pages。下面 5 招围绕"Hexo v8.1.2 上线部署"展开。
// Hexo v8.1.2 部署 5 段伪代码（按 README + 助手中文 README 顺序） /* 第一段:全局装 hexo-cli */ npm install hexo-cli -g hexo --version // 应该看到:hexo-cli: 4.3.2 / hexo: 8.1.2 /* 第二段:初始化站点 */ hexo init my-blog cd my-blog npm install hexo server // 浏览器访问 http://localhost:4000 /* 第三段:写新文章 */ hexo new post "我的第一篇 Hexo 教程" # 编辑 source/_posts/我的第一篇-Hexo-教程.md hexo generate // 生成静态 HTML hexo server // 本地预览 /* 第四段:配置 _config.yml */ url: https://yourname.github.io theme: next // 推荐 Next 主题 deploy: type: git repo: https://github.com/yourname/yourname.github.io.git branch: main /* 第五段:部署到 GitHub Pages */ npm install hexo-deployer-git --save hexo clean && hexo generate && hexo deploy // 5 分钟后访问 https://yourname.github.io
第 1 招[判断标准]:认准 GitHub hexojs/hexo 官方仓库的 v8.1.2 tag,不要下 master 分支(可能不稳定)
第 2 招[避坑点]:Hexo 是 Node.js 框架(≥ 20.19),必须先装 Node.js + npm,跟 WordPress 的 PHP 完全不一样
第 3 招[关键参数]:Node.js ≥ 20.19(package.json engines 强制要求),低于这个 npm install 会报 EBADENGINE
第 4 招[易踩坑]:Hexo 装好后是 空站点,不会自动有文章,必须
hexo new post "标题"创建 Markdown 文件第 5 招[场景建议]:先用默认主题 landscape + hexo server 本地预览 → 通过后再换 next / yilia 等第三方主题
5 个避坑点（踩过就懂）
当成 WordPress 安装 — Hexo 是 Node.js 静态站点生成器,不要找 PHP / MySQL / Apache
Node.js < 20.19 — package.json 强制 ≥ 20.19,EBADENGINE 报错就升级 Node
装完找不到文章 — 必须
hexo new post创建,默认空站点下 master 分支 — master 可能带未发布代码,先看 tag 选稳定版
主题不切换 — 先用默认 landscape 通过测试,再换 next / yilia
下载包里有什么（4 件套,跟 zip 一一对得上）
| 文件 | 大小 | 用途 |
|---|---|---|
| Hexo v8.1.2 整站框架包(无 md 版) | 596KB | 官方整站源码,151 个文件,TypeScript 实现,含 hexo.ts / post.ts / generate.ts / category.ts 等核心模块 |
| package.json | 2.5KB | Node.js 工程配置,hexo-cli 命令 + 依赖清单 + engines: Node ≥ 20.19 + MIT License |
| README.txt | 3.7KB | Hexo 官方 README(英文):Quick Start / npm install hexo-cli -g / 主题插件生态介绍 |
| README.txt | 572B | 助手加的中文简短说明(Node 18+ + hexo new/server/deploy 命令 + GitHub Pages 托管建议) |
为什么必须下载:相比 npm install hexo-cli -g 全局装,这个包多了 整站源码(可自定义修改 hexo.ts) + 中文 README 启动指南(新手最缺的是"装完怎么跑"),151 个 .ts 文件全是 TypeScript 源码,你想魔改 Hexo 内核直接改 hexo.ts 重 build 即可。
一句话总结:整站框架包 = 干净无后门 v8.1.2;package.json = Node 20+ 配置;README.txt = 官方英文 Quick Start;README.txt = 中文简短说明。光看文章懂思路不会装,光有 npm 不会魔改,4 件套必须一起下。
