想写技术博客又不想折腾服务器？WordPress 需要买 VPS、装数据库、常年维护；Hexo 给出了另一条路：静态博客。它把 Markdown 文章编译成纯 HTML 文件，部署到 GitHub Pages 或自己的 VPS 上，速度快、零数据库、几乎不需要维护成本，还可以用免费空间托管。这篇文章从零开始，教你用 Hexo 搭建一个属于自己的技术博客。
一、Hexo 是什么
Hexo 是一个基于 Node.js 的静态博客框架，核心工作流程是：
- 用 Markdown 写文章
- 运行
hexo g把文章编译成静态 HTML - 运行
hexo d部署到服务器或 GitHub Pages
相比动态博客，它的优势明显：
- 速度快：全是静态文件，无需数据库查询，访问秒开
- 零维护：不怕被黑、不需要备份数据库、不用更新补丁
- 免费：GitHub Pages 提供免费托管，域名都不用买也能访问
- 写作专注：纯 Markdown 写作，配合代码高亮，非常适合技术博客
二、环境准备：安装 Node.js 和 Git
Hexo 基于 Node.js，需要先装好 Node.js 和 Git（Git 安装见本站专门教程）：
# 检查是否已安装
node -v
npm -v
git --version
如果没有，参考本站的 Node.js 安装教程用 nvm 安装：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
三、安装 Hexo 并初始化博客
npm install -g hexo-cli
# 创建博客目录
hexo init myblog
cd myblog
# 安装依赖
npm install
# 本地预览
hexo server
浏览器访问 http://localhost:4000，就能看到默认博客页面了。按 Ctrl+C 停止预览。
四、写第一篇文章
hexo new post "我的第一篇文章"
这会生成 source/_posts/我的第一篇文章.md，用编辑器打开写内容：
---
title: 我的第一篇文章
date: 2026-09-21 10:00:00
tags: [博客, Hexo]
categories: 技术笔记
---
这是我的第一篇 Hexo 博客文章。
## 代码高亮
```bash
echo "Hello Hexo"
保存后重新生成并预览：
```bash
hexo clean && hexo g && hexo server
五、配置站点信息
编辑博客根目录的 _config.yml：
# 站点信息
title: 我的博客
subtitle: 记录技术成长
description: 分享 Linux、VPS、编程心得
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai
# 网址（部署到自有域名时填写）
url: https://blog.example.com
六、部署到 GitHub Pages（免费）
1. 创建 GitHub 仓库
在 GitHub 新建仓库，命名格式必须是 用户名.github.io。
2. 安装部署插件
npm install hexo-deployer-git --save
3. 配置部署信息
在 _config.yml 末尾添加：
deploy:
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git
branch: main
4. 一键部署
hexo clean && hexo g && hexo d
等一分钟，访问 https://你的用户名.github.io，博客就上线了。
七、部署到自己的 VPS
如果想用自己买的 VPS 和域名，部署也很简单：
1. 在 VPS 上安装 Nginx 并创建站点目录：
mkdir -p /www/wwwroot/blog
2. 本地编译后，用 rsync 或 git 推送静态文件：
hexo clean && hexo g
rsync -avz --delete public/ root@服务器IP:/www/wwwroot/blog/
3. 配置 Nginx 指向该目录，并申请 SSL 证书，网站就正式上线了。
（Nginx 配置参考本站 LNMP 教程和宝塔面板教程）
八、必装插件与主题
常用插件：
npm install hexo-generator-sitemap --save # 站点地图，利于 SEO
npm install hexo-deployer-git --save # Git 部署
npm install hexo-generator-search --save # 站内搜索
推荐主题： Hexo 官方主题市场有几百款主题，next、butterfly、fluid 是中文用户用得最多的三款。安装方法：
git clone https://github.com/theme-next/hexo-theme-next themes/next
然后在 _config.yml 中修改：
theme: next
九、常用命令速查
hexo new post "文章标题" # 新建文章
hexo g # 生成静态文件
hexo s # 本地预览
hexo d # 部署
hexo clean # 清理缓存
hexo new page "about" # 新建独立页面（如关于页）
十、常见问题
Q1：hexo d 部署时报认证失败？
GitHub 已取消密码推送，需要用令牌（Personal Access Token）或 SSH 密钥。推荐配置 SSH 密钥后，把 _config.yml 里的 repo 改为 git@github.com:用户名/仓库名.git。
Q2：文章修改后不生效？
先 hexo clean 清理缓存再重新生成部署，静态博客必须重新编译。
Q3：想绑定自己的域名？
在 source/ 目录创建 CNAME 文件，内容写你的域名，然后在域名服务商把域名 CNAME 解析到 用户名.github.io。
总结
Hexo 是最适合技术博客的静态方案：Markdown 写作、一条命令部署、免费托管、访问飞快。从安装到上线，熟练后十几分钟就能搞定。如果你追求"低成本、快速度、专注写作"，Hexo 值得一试。