简介

Thu, 01 Oct 2026 00:00:00 +0800

Hugo 是什么

Hugo 是用 Go 编写的静态站点生成器，针对速度做了优化，并以灵活性为设计目标。它提供先进的模板系统和快速的资源管道，渲染一个完整站点通常只需数秒，很多时候还要更短。

由于框架灵活、原生支持多语言，并具备强大的分类系统，Hugo 被广泛用于创建以下类型的站点：

这些用途覆盖了从内容发布到项目展示的多数场景；多语言支持与分类系统让同一套站点结构可以同时服务于不同语言、不同维度的内容组织。

Thu, 01 Oct 2026 00:00:00 +0800

跨平台: 在 Linux、macOS、Windows 等系统上安装单个可执行文件即可使用。
多语言: 为每种语言和地区本地化项目，包括翻译、图片、日期、货币、数字与排序规则；支持单主机与多主机配置。
输出格式: 把页面渲染为一种或多种输出格式，可按页面类型、section 和路径控制；HTML 为默认格式，还可添加 JSON、RSS、CSV 等。
模板: 用变量、函数和方法编写模板，把内容、资源和数据转换成发布的页面；也可为任何输出格式创建模板。
主题: 使用社区贡献的数百个主题减少开发时间和成本；主题覆盖企业站点、文档项目、作品集、落地页、博客、简历等。可从 themes.gohugo.io 获取。
模块: 创建或导入打包好的原型、资源、内容、数据、模板、翻译表、静态文件或配置；模块可作为新项目的基础，也可增强已有项目。
隐私: 通过配置项目，帮助符合各地区的隐私法规。
安全: 安全模型假定模板与配置作者可信、内容作者不可信，可生成防范代码注入的 HTML；其他保护可阻止调用任意应用、限制环境变量访问、阻止连接任意远程数据源。

内容格式: 支持 Markdown、HTML、AsciiDoc、Emacs Org Mode、Pandoc 与 reStructuredText；默认的 Markdown 遵循 CommonMark 与 GitHub Flavored Markdown 规范。
Markdown 属性: 为 Markdown 图片和块级元素（引用块、代码块、标题、分隔线、列表、段落、表格）添加 class、id 等属性。
Markdown 扩展: 利用内置扩展创建表格、定义列表、脚注、任务列表、插入文本、标记文本、下标、上标等。
Markdown 渲染钩子: 渲染引用块、代码块、标题、图片、链接和表格时，可覆盖 Markdown 到 HTML 的转换，例如把独立图片渲染为 figure 元素。
图表: 用围栏代码块和渲染钩子在内容中加入图表。
数学公式: 用 LaTeX 标记在 Markdown 中加入数学公式和表达式。
语法高亮: 用内置高亮器高亮代码，Markdown 围栏代码块默认启用；支持数百种语言和数十种样式。
短代码: 使用内置短代码或自行创建，插入复杂内容，例如 audio、video 元素、从数据源渲染表格、插入其他页面的片段。

CSS 处理: 打包、转换、压缩、生成 source map、SRI 哈希，并集成 PostCSS。
图像处理: 转换、缩放、裁剪、旋转、调整颜色、应用滤镜、叠加文字和图片，以及提取元数据。
JavaScript 打包: 把 TypeScript 与 JSX 转译为 JavaScript，并打包、tree shake、压缩、生成 source map、SRI 哈希。
Sass 处理: 把 Sass 转译为 CSS，并打包、tree shake、压缩、生成 source map、SRI 哈希，可集成 PostCSS。
Tailwind CSS 处理: 把 Tailwind CSS 工具类编译为标准 CSS，并打包、tree shake、优化、压缩、SRI 哈希，可集成 PostCSS。

Thu, 01 Oct 2026 00:00:00 +0800

上游文档说明，Hugo 依据 Apache License 2.0 发布。以下按该许可原文的章节结构转述其使用、复制与分发条款；完整条款以 http://www.apache.org/licenses/ 上的许可原文为准。

版本 2.0，2004 年 1 月

Thu, 01 Oct 2026 00:00:00 +0800

layouts 中的模板是可信的。
archetypes、assets、resources、data、i18n 和 static 中的资源是可信的。
content 中的内容，以及由内容适配器在 content 中生成的内容，是不可信的；唯一例外是启用内联短代码时。对于内容适配器，这一范围仅限于适配器的输出结果。
开发服务器 hugo server 及其 livereload 脚本是可信的，仅用于本地开发。
Hugo 没有线上生产服务器；任何导致构建失败的畸形输入（例如格式错误的内容前置元数据）都不被定义为拒绝服务（DoS）。这也包括触发运行时错误的输入，例如 fatal error: stack overflow；这类问题请作为缺陷报告。

Hugo 生成的是静态网站：最终输出直接在浏览器中运行，并与所集成的各类 API 交互。但在开发和构建站点期间，hugo 可执行文件本身就是运行时环境。