Hugo / Hexo 生成静态站

更新于 2026年8月21日

适用人群：准备用 Hugo 或 Hexo 把 Markdown 内容构建成静态站的开发者。

核心概念

构建产物

生成器把源文件（Markdown + 主题模板）编译成纯静态文件，Hugo 默认输出到 public/，Hexo 输出到 public/。这个目录就是最终要部署到服务器的内容。

本地预览

两者都自带本地开发服务器（hugo server / hexo server），可在浏览器实时预览，改内容即时刷新，确认无误再构建正式产物。

baseURL / url

构建前要把配置里的站点地址（Hugo 的 baseURL、Hexo 的 url）设成正式域名的 https:// 地址，否则生成的绝对链接、sitemap、RSS 会指向错误地址。

操作步骤

步骤 1安装生成器
Hugo 下载对应平台二进制或用包管理器；Hexo 用 npm 全局安装（需先装 Node.js）。
步骤 2初始化站点
hugo new site 或 hexo init 创建项目骨架，再安装一个主题。
步骤 3写内容
在 content/（Hugo）或 source/_posts/（Hexo）用 Markdown 写文章，带 front matter 元信息。
步骤 4本地预览
hugo server 或 hexo server 启动本地服务，浏览器预览效果。
步骤 5构建产物
设好 baseURL/url 后运行 hugo 或 hexo generate，得到 public/ 静态文件。

实际示例

# Hugo
hugo new site myblog && cd myblog
# 安装主题后写内容，再构建：
hugo --minify        # 产物在 public/

# Hexo
npm install -g hexo-cli
hexo init myblog && cd myblog && npm install
hexo generate        # 产物在 public/

常见错误

⚠️baseURL/url 没改成正式域名，生成的链接、sitemap、RSS 指向 localhost 或错误域名
⚠️主题依赖没装全（Hexo 需 npm install），构建报错或页面缺样式
⚠️把源码目录当产物上传，实际要上传的是 public/ 里的静态文件

对应工具

在线工具箱→robots.txt 生成→

常见问题

Hugo 和 Hexo 哪个快？

Hugo 用 Go 编写，构建速度非常快、单二进制无依赖；Hexo 基于 Node，生态和主题丰富，中文用户多。按熟悉度和主题需求选。

构建产物是哪个目录？

都是 public/。部署时上传 public/ 里的文件，而不是整个源码项目。

联系客服