ghcr.io/gohugoio/hugo:v0.151.0

由 https://github.com/bep、https://github.com/spf13 和 https://github.com/gohugoio/hugo/graphs/contributors 用 Go 精心打造的快速灵活的静态网站生成器。

---

[网站][] | [安装][] | [文档][] | [支持][] | [贡献][] | ***

概述

Hugo 是一个用 Go 编写的[静态网站生成器][]，针对速度进行了优化，并为灵活性而设计。凭借其先进的模板系统和快速的资源处理管道，Hugo 能在几秒钟内（通常更短）渲染出完整的网站。

由于其灵活的框架、多语言支持和强大的分类系统，Hugo 被广泛用于创建：

• 企业、***、非营利组织、教育、新闻、活动和项目网站
• 文档网站
• 图片作品集
• 着陆页
• 商业、专业和个人博客
• 简历和履历

开发期间使用 Hugo 的嵌入式 Web 服务器，可即时查看内容、结构、行为和呈现方式的变化。然后将网站部署到您的主机，或将更改推送到您的 Git 提供商以进行自动构建和部署。

Hugo 的快速资源处理管道包括：

• CSS 处理 - 捆绑、转换、压缩、创建源映射、执行 SRI 哈希以及与 PostCSS 集成。
• 图像处理 - 转换、调整大小、裁剪、旋转、调整颜色、应用滤镜、叠加文本和图像以及提取元数据
• JavaScript 捆绑 - 将 TypeScript 和 JSX 转译为 JavaScript、捆绑、摇树优化、压缩、创建源映射以及执行 SRI 哈希。
• Sass 处理 - 将 Sass 转译为 CSS、捆绑、摇树优化、压缩、创建源映射、执行 SRI 哈希以及与 PostCSS 集成
• Tailwind CSS 处理 - 将 Tailwind CSS 工具类编译为标准 CSS、捆绑、摇树优化、优化、压缩、执行 SRI 哈希以及与 PostCSS 集成

借助https://gohugo.io/hugo-modules/，您可以通过公共或私有 Git 仓库与其他项目共享内容、资源、数据、翻译、主题、模板和配置。

有关 Hugo 功能的全面摘要，请参阅文档的[功能][]部分。

赞助商

 

   

版本

Hugo 有多个版本可用。除非您需要额外功能，否则请使用标准版。

(1) 直接将网站部署到 Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器。详见[详情][]。

(2) 通过嵌入式 LibSass [将 Sass 转译为 CSS][]。请注意，嵌入式 LibSass 在 v0.153.0 中已被弃用，并将在未来版本中移除。请改用 https://gohugo.io/functions/css/sass/#dart-sass 转译器，它与任何版本都兼容。

安装

从[预构建二进制文件][]、包管理器或包仓库安装 Hugo。请参阅适用于您操作系统的安装说明：

• https://gohugo.io/installation/macos
• https://gohugo.io/installation/linux
• https://gohugo.io/installation/windows
• [DragonFly BSD、FreeBSD、NetBSD 和 OpenBSD][]

从源代码构建

要从源代码构建 Hugo，您必须安装：

1. https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
2. https://go.dev/doc/install 版本 1.26.0 或更高版本

标准版

要构建并安装标准版：

CGO_ENABLED=0 go install github.com/gohugoio/hugo@latest

部署版

要构建并安装部署版：

CGO_ENABLED=0 go install -tags withdeploy github.com/gohugoio/hugo@latest

扩展版

要构建并安装扩展版，首先安装 C 编译器（如 https://gcc.gnu.org/ 或 https://clang.llvm.org/），然后运行以下命令。

CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest

扩展/部署版

要构建并安装扩展/部署版，首先安装 C 编译器（如 https://gcc.gnu.org/ 或 https://clang.llvm.org/），然后运行以下命令。

CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest

星级历史

文档

Hugo 的[文档][]包括安装说明、快速入门指南、概念解释、参考信息和示例。

请将文档问题和拉取请求提交到[文档仓库][]。

支持

请不要使用问题队列来提问或进行故障排除。除非您确定您的问题是软件缺陷，否则请使用[论坛][]。

Hugo 的[论坛][]是一个活跃的用户和开发者社区，他们回答问题、分享知识并提供示例。搜索超过 20,000 个主题通常能找到您问题的答案。在提出第一个问题之前，请务必阅读[请求帮助][]的相关内容。

贡献

您可以通过以下方式为 Hugo 项目做出贡献：

• 在[论坛][]上回答问题
• 改进[文档][]
• 监控[问题队列][]
• 创建或改进[主题][]
• 修复[错误][]

请将文档问题和拉取请求提交到[文档仓库][]。

如果您有增强功能或新功能的想法，请在[论坛][]的“功能”类别中创建新主题。这将帮助您：

• 确定该功能是否已存在
• 衡量兴趣
• 完善概念

如果有足够的兴趣，请https://github.com/gohugoio/hugo/issues/new?labels=Proposal%2C+NeedsTriage&template=feature_request.md。在项目负责人接受提案之前，请勿提交拉取请求。

有关为 Hugo 贡献的完整指南，请参阅贡献指南。

许可证

Hugo 源代码的许可证，请参见LICENSE。

我们还以二进制/WASM 形式捆绑了一些库：

• https://github.com/webmproject/libwebp%EF%BC%8Chttps://github.com/webmproject/libwebp?tab=BSD-3-Clause-1-ov-file#readme
• https://github.com/KaTeX/KaTeX%EF%BC%8Chttps://github.com/KaTeX/KaTeX?tab=MIT-1-ov-file#readme
• https://github.com/bellard/quickjs?tab=License-1-ov-file#readme%EF%BC%8Chttps://github.com/bellard/quickjs?tab=License-1-ov-file#readme

依赖项

Hugo 依赖于众多优秀的开源库。运行 hugo env --logLevel info 可显示依赖项列表。

查看当前依赖项

github.com/BurntSushi/locker="v0.0.0-20171006230638-a6e239ea1c69"
github.com/JohannesKaufmann/dom="v0.2.0"
github.com/JohannesKaufmann/html-to-markdown/v2="v2.5.0"
github.com/alecthomas/chroma/v2="v2.21.1"
github.com/aymerick/douceur="v0.2.0"
github.com/bep/clocks="v0.5.0"
github.com/bep/debounce="v1.2.0"
github.com/bep/gitmap="v1.9.0"
github.com/bep/goat="v0.5.0"
github.com/bep/godartsass/v2="v2.5.0"
github.com/bep/golibsass="v1.2.0"
github.com/bep/goportabletext="v0.1.0"
github.com/bep/helpers="v0.6.0"
github.com/bep/imagemeta="v0.12.0"
github.com/bep/lazycache="v0.8.0"
github.com/bep/logg="v0.4.0"
github.com/bep/mclib="v1.20400.20402"
github.com/bep/overlayfs="v0.10.0"
github.com/bep/simplecobra="v0.6.1"
github.com/bep/textandbinarywriter="v0.0.0-20251212174530-cd9f0732f60f"
github.com/bep/tmc="v0.5.1"
github.com/bits-and-blooms/bitset="v1.24.4"
github.com/cespare/xxhash/v2="v2.3.0"
github.com/clbanning/mxj/v2="v2.7.0"
github.com/clipperhouse/displaywidth="v0.6.0"
github.com/clipperhouse/stringish="v0.1.1"
github.com/clipperhouse/uax29/v2="v2.3.0"
github.com/cpuguy83/go-md2man/v2="v2.0.6"
github.com/disintegration/gift="v1.2.1"
github.com/dlclark/regexp2="v1.11.5"
github.com/evanw/esbuild="v0.27.2"
github.com/fatih/color="v1.18.0"
github.com/frankban/quicktest="v1.14.6"
github.com/fsnotify/fsnotify="v1.9.0"
github.com/getkin/kin-openapi="v0.133.0"
github.com/go-openapi/jsonpointer="v0.21.0"
github.com/go-openapi/swag="v0.23.0"
github.com/gobuffalo/flect="v1.0.3"
github.com/gobwas/glob="v0.2.3"
github.com/goccy/go-yaml="v1.19.1"
github.com/gohugoio/go-i18n/v2="v2.1.3-0.20251018145728-cfcc22d823c6"
github.com/gohugoio/go-radix="v1.2.0"
github.com/gohugoio/hashstructure="v0.6.0"
github.com/gohugoio/httpcache="v0.8.0"
github.com/gohugoio/hugo-goldmark-extensions/extras="v0.5.0"
github.com/gohugoio/hugo-goldmark-extensions/passthrough="v0.3.1"
github.com/gohugoio/locales="v0.14.0"
github.com/gohugoio/localescompressed="v1.0.1"
github.com/google/go-cmp="v0.7.0"
github.com/gorilla/css="v1.0.1"
github.com/gorilla/websocket="v1.5.3"
github.com/hairyhenderson/go-codeowners="v0.7.0"
github.com/hashicorp/golang-lru/v2="v2.0.7"
github.com/jdkato/prose="v1.2.1"
github.com/josharian/intern="v1.0.0"
github.com/kr/pretty="v0.3.1"
github.com/kr/text="v0.2.0"
github.com/kyokomi/emoji/v2="v2.2.13"
github.com/mailru/easyjson="v0.7.7"
github.com/makeworld-the-better-one/dither/v2="v2.4.0"
github.com/marekm4/color-extractor="v1.2.1"
github.com/mattn/go-colorable="v0.1.13"
github.com/mattn/go-isatty="v0.0.20"
github.com/mattn/go-runewidth="v0.0.19"
github.com/microcosm-cc/bluemonday="v1.0.27"
github.com/mitchellh/mapstructure="v1.5.1-0.20231216201459-8508981c8b6c"
github.com/mohae/deepcopy="v0.0.0-20170929034955-c48cc78d4826"
github.com/muesli/smartcrop="v0.3.0"
github.com/niklasfasching/go-org="v1.9.1"
github.com/oasdiff/yaml3="v0.0.0-20250309153720-d2182401db90"
github.com/oasdiff/yaml="v0.0.0-20250309154309-f31be36b4037"
github.com/olekukonko/cat="v0.0.0-20250911104152-50322a0618f6"
github.com/olekukonko/errors="v1.1.0"
github.com/olekukonko/ll="v0.1.3"
github.com/olekukonko/tablewriter="v1.1.2"
github.com/pbnjay/memory="v0.0.0-20210728143218-7b4eea64cf58"
github.com/pelletier/go-toml/v2="v2.2.4"
github.com/perimeterx/marshmallow="v1.1.5"
github.com/pkg/browser="v0.0.0-20240102092130-5ac0b6a4141c"
github.com/pkg/errors="v0.9.1"
github.com/rogpeppe/go-internal="v1.14.1"
github.com/russross/blackfriday/v2="v2.1.0"
github.com/sass/dart-sass/compiler="1.97.1"
github.com/sass/dart-sass/implementation="1.97.1"
github.com/sass/dart-sass/protocol="3.2.0"
github.com/spf13/afero="v1.15.0"
github.com/spf13/cast="v1.10.0"
github.com/spf13/cobra="v1.10.2"
github.com/spf13/fsync="v0.10.1"
github.com/spf13/pflag="v1.0.9"
github.com/tdewolff/minify/v2="v2.24.8"
github.com/tdewolff/parse/v2="v2.8.5"
github.com/tetratelabs/wazero="v1.10.1"
github.com/webmproject/libwebp="v1.6.0"
github.com/woodsbury/decimal128="v1.3.0"
github.com/yuin/goldmark-emoji="v1.0.6"
github.com/yuin/goldmark="v1.7.13"
go.uber.org/automaxprocs="v1.5.3"
go.yaml.in/yaml/v3="v3.0.4"
golang.org/x/crypto="v0.46.0"
golang.org/x/image="v0.34.0"
golang.org/x/mod="v0.31.0"
golang.org/x/net="v0.48.0"
golang.org/x/sync="v0.19.0"
golang.org/x/sys="v0.39.0"
golang.org/x/text="v0.32.0"
golang.org/x/tools="v0.40.0"
google.golang.org/protobuf="v1.36.10"
gopkg.in/yaml.v3="v3.0.1"
rsc.io/qr="v0.2.0"
software.sslmate.com/src/go-pkcs12="v0.2.0"