Hexo 静态博客怎么搭：从内容目录、主题到部署流程

Hexo 适合把 Markdown 笔记整理成静态博客。它的优势是结构简单、部署成本低、页面访问快；缺点是后台编辑、权限、评论和媒体管理都需要额外方案。

如果只是做个人技术站、项目文档或轻量内容归档，Hexo 是一个很顺手的选择。真正要用稳，关键不是记住几条命令，而是提前把内容目录、主题改动和部署流程想清楚。

先理解 Hexo 的目录

Hexo 项目里最重要的几个位置是：

source/_posts/   文章 Markdown
themes/          主题
public/          生成后的静态文件
_config.yml      站点配置

日常写文章主要在 source/_posts。文章头部用 front matter 写标题、日期、分类和标签：

---
title: 一篇技术笔记
date: 2026-07-03
categories: 工具
tags:
  - Hexo
---

public/ 是构建产物，不应该当成手写内容入口。主题目录也要谨慎改，能通过配置解决的，不要直接修改主题源码；真要改主题，最好记录改动点，避免升级时找不到差异。

常用命令

本地预览：

hexo server

生成静态文件：

hexo generate

清理缓存和旧产物：

hexo clean

一般排障顺序是先 hexo clean，再 hexo generate，最后本地 hexo server 看页面是否正常。

部署方式怎么选

Hexo 生成的是静态文件，所以部署选择很多：

• GitHub Pages
• Cloudflare Pages
• Nginx 静态目录
• 对象存储加 CDN

个人站最省心的是 Pages 类平台。自己用服务器部署时，可以把 public/ 同步到 Nginx 静态目录，或者让 CI 在构建后发布。

更稳的流程是：

1. 本地或 CI 生成 public/。
2. 自动检查链接和构建结果。
3. 发布到目标静态托管服务。
4. 保留源 Markdown 在 Git 仓库里。

内容和图片要分开治理

Hexo 写文章很快，但图片管理容易乱。建议从一开始就定规则：

• 文章图片放到固定 assets 目录。
• 文件名用英文 slug 或日期前缀。
• 不依赖本机绝对路径。
• 发布前检查图片是否能在线访问。

如果图片越来越多，可以考虑对象存储或图床，但要注意链接稳定性。技术博客最怕的是文章还在，图片全挂了。

实用结论

Hexo 的定位是“把 Markdown 快速生成静态站”。它适合轻量博客和文档站，不适合复杂内容运营后台。

搭建时先把源文、主题、构建产物、图片和部署流程分清楚。这样后续换主题、迁移服务器或接入 CI 时，站点不会变成一堆难以追踪的静态文件。