Hugo：Go 编写的极速静态网站生成框架（gohugoio/hugo）
Hugo 是一个用 Go 编写的快速、灵活的静态网站生成器，由 bep、spf13 及社区开发者共同维护。它具备高级模板系统与快速资源管道（CSS、图片、JavaScript、Sass、Tailwind CSS 处理），可在数秒甚至更短时间内渲染完整站点，并内置开发用 Web 服务器与 Hugo Modules 模块共享机制，广泛用于企业、政府、非营利、教育、新闻、活动、项目站点、文档站、作品集、落地页、博客和简历等场景。
社区作者 · zZz
它解决什么问题
项目定位
Hugo 是一个用 Go 编写的静态网站生成器，针对速度进行优化，并以灵活性为设计目标。借助高级模板系统与快速资源管道，Hugo 可以在数秒内（通常更短）渲染出完整站点。
由于其灵活的框架、多语言支持和强大的分类（taxonomy）系统，Hugo 被广泛用于创建：
- 企业、政府、非营利组织、教育、新闻、活动与项目站点
- 文档站点
- 图片作品集
- 落地页
- 商业、专业及个人博客
- 简历与 CV
在开发阶段可使用 Hugo 内置的 Web 服务器即时查看内容、结构、行为和呈现的变化；随后可将站点部署到目标主机，或把变更推送到 Git 提供方以触发自动化构建与部署。
（配图 1 为 Hugo 项目 Logo；配图 2 为 GoDoc 徽标；配图 3 为赞助方 GoLand 标识；配图 4 为赞助方 CloudCannon 标识。）
快速资源管道
Hugo 的快速资源管道包括：
- **CSS 处理**：打包（Bundle）、转换、压缩（minify）、生成 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 集成。
通过 **Hugo Modules**，可以在公开或私有 Git 仓库之间共享内容、资产、数据、翻译、主题、模板与配置。
文档的 features 章节提供了 Hugo 能力的完整概览。
版本（Editions）
Hugo 提供多个版本。除非确实需要额外功能，否则使用 standard（标准）版即可。
| 功能 | standard | deploy | extended | extended/deploy | | --- | --- | --- | --- | --- | | 核心功能 | ✔️ | ✔️ | ✔️ | ✔️ | | 直接云部署（1） | ❌ | ✔️ | ❌ | ✔️ | | LibSass 支持（2） | ❌ | ❌ | ✔️ | ✔️ |
（1）可直接把站点部署到 Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器。
（2）通过内嵌 LibSass 把 Sass 转译为 CSS。注意：内嵌 LibSass 已在 v0.153.0 中弃用，并将在未来版本中移除。请改用 Dart Sass 转译器，它与任何版本都兼容。
赞助方
项目页面列出了赞助方信息（页面中展示 GoLand、CloudCannon 等赞助标识，见配图 3、配图 4）。
支持渠道
请不要用 issue 队列提问或排障。除非确定问题是软件缺陷，否则请使用论坛。Hugo 论坛是一个活跃的用户与开发者社区，可以回答问题、分享知识并提供示例；搜索 20,000 多个主题往往就能解答疑问。提问前请先阅读关于“如何请求帮助”的说明。
贡献方式
可以通过以下方式为 Hugo 项目做贡献：
- 在论坛回答问题
- 改进文档
- 监控 issue 队列
- 创建或改进主题
- 修复缺陷（squash bugs）
文档相关问题与 PR 请提交到文档仓库。如果有增强或新功能的想法，请在论坛的 “Feature” 分类下新建主题，这有助于：判断该能力是否已存在、评估关注度、完善概念。如果兴趣足够，再创建 proposal。在项目负责人接受 proposal 之前，不要提交 pull request。
完整的贡献指南见 Contribution Guide。
许可证与捆绑库
Hugo 源代码的许可证见仓库中的 LICENSE 文件。项目还以二进制/WASM 形式捆绑了一些库：
- libwebp：BSD-3-Clause 许可证
- Katex：MIT 许可证
- QuickJS：许可证见原文标注（未具名）
依赖
Hugo 建立在众多优秀开源库之上。运行 hugo env --logLevel info 可以显示依赖列表。页面同时给出了当前依赖清单，包括云存储与认证（cloud.google.com/go/storage、AWS SDK、Azure SDK）、OpenTelemetry、Chroma 语法高亮、Goldmark、esbuild、Dart Sass、libwebp、Tailwind 相关依赖等大量模块。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、常规安装（推荐）
从预编译二进制（prebuilt binary）、包管理器（package manager）或包仓库（package repository）安装 Hugo。请按操作系统查看对应的安装说明：
- macOS
- Linux
- Windows
- DragonFly BSD、FreeBSD、NetBSD、OpenBSD
二、从源码构建
1. 准备环境
从源码构建 Hugo 必须先安装：
GitGo 1.26.0 或更高版本如果要构建 extended 或 extended/deploy 版本，还需要先安装 C 编译器，例如 GCC 或 Clang。
2. 按版本执行安装命令
**标准版（standard）**：
CGO_ENABLED=0 go install github.com/gohugoio/hugo@latest**deploy 版**：
CGO_ENABLED=0 go install -tags withdeploy github.com/gohugoio/hugo@latest**extended 版**（需先安装 GCC 或 Clang 等 C 编译器）：
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest**extended/deploy 版**（需先安装 GCC 或 Clang 等 C 编译器）：
CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest3. 首次运行与开发预览
开发期间使用 Hugo 内置的 Web 服务器，可即时看到内容、结构、行为和呈现的变化；确认无误后再把站点部署到主机，或把变更推送到 Git 提供方以触发自动化构建与部署。
查看当前依赖列表可运行：
hugo env --logLevel info4. 文档
Hugo 的文档包含安装说明、快速开始指南、概念解释、参考资料和示例。文档问题与 PR 请提交到文档仓库。
三、常见问题
- **该选哪个版本？** 除非需要额外功能，否则使用 standard 版即可。需要直接部署到云端（Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器）选 deploy 版；需要内嵌 LibSass 选 extended 版。
- **LibSass 相关**：内嵌 LibSass 已在 v0.153.0 中弃用，并将在未来版本中移除，建议改用 Dart Sass 转译器（与任何版本都兼容）。
- **求助渠道**：不要用 issue 队列提问或排障；除非确定是软件缺陷，否则请到论坛提问，并先阅读“请求帮助”的相关说明。
- **功能建议流程**：先在论坛 “Feature” 分类新建主题，再视关注度创建 proposal，proposal 被项目负责人接受后才提交 PR。
