HUGO

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
gohugoio Star
  • 关于
    • 本节内容
    • 简介
    • 特性
    • 隐私
    • 安全
    • 许可证
  • 安装
    • 本节内容
    • macOS
    • Linux
    • Windows
    • BSD
  • 入门
    • 本节内容
    • 快速开始
    • 基本用法
    • 目录结构
    • 配置
    • 配置标记
    • 配置构建
    • 术语表
    • 外部学习资源
  • 快速参考
    • 本节内容
    • 表情符号
    • 函数
    • 方法
    • 页面集合
  • 内容管理
    • 本节内容
    • 组织
    • 页面包
    • 内容格式
    • Front matter
    • 构建选项
    • 页面资源
    • 图像处理
    • 简码
    • 相关内容
    • 章节
    • 内容类型
    • 原型
    • 分类法
    • 摘要
    • 链接和交叉引用
    • URL 管理
    • 菜单
    • 评论
    • 多语言
    • Markdown 属性
    • 语法高亮
    • 图表
    • 数学
    • 数据源
    • 内容适配器
  • 模板
    • 本节内容
    • 简介
    • 模板类型
    • 查找顺序
    • 基础模板
    • 主页模板
    • 单页模板
    • 章节模板
    • 分类模板
    • 术语模板
    • 局部模板
    • 内容视图模板
    • 简码模板
    • 站点地图模板
    • RSS 模板
    • 404 模板
    • robots.txt 模板
    • 菜单
    • 分页
    • 嵌入式模板
    • 自定义输出格式
  • 函数
    • 本节内容
    • cast
    • collections
    • compare
    • crypto
    • css
    • data
    • debug
    • diagrams
    • encoding
    • fmt
    • global
    • go template
    • hash
    • hugo
    • images
    • inflect
    • js
    • lang
    • math
    • openapi3
    • os
    • partials
    • path
    • reflect
    • resources
    • safe
    • strings
    • templates
    • time
    • transform
    • urls
  • 方法
    • 本节内容
    • Duration
    • Menu
    • 菜单项
    • 页面
    • Pager
    • 页面集
    • 资源
    • 简码
    • 站点
    • 分类法
    • 时间
  • 渲染钩子
    • 本节内容
    • 简介
    • 块引用
    • 代码块
    • 标题
    • 图像
    • 链接
    • 传递
    • 表格
  • 简码
    • 本节内容
    • 评论
    • 详情
    • 图表
    • Gist
    • 高亮
    • Instagram
    • 参数
    • QR
    • Ref
    • Relref
    • Vimeo
    • X
    • YouTube
  • Hugo 模块
    • 本节内容
    • 配置 Hugo 模块
    • 使用 Hugo 模块
    • 主题组件
  • Hugo Pipes
    • 本节内容
    • 简介
    • 将 Sass 转译为 CSS
    • PostCSS
    • 后处理
    • JavaScript 构建
    • 资源压缩
    • 连接资源
    • 指纹识别和 SRI 哈希
    • 来自字符串的资源
    • 来自模板的资源
  • CLI
  • 故障排除
    • 本节内容
    • 审计
    • 日志记录
    • 检查
    • 弃用
    • 性能
    • 常见问题
  • 开发者工具
    • 本节内容
    • 编辑器插件
    • 前端
    • 搜索
    • 迁移
    • 其他项目
  • 托管和部署
    • 本节内容
    • Hugo Deploy
    • 使用 Rclone 部署
    • 使用 Rsync 部署
    • 在 21YunBox 上托管
    • 在 AWS Amplify 上托管
    • 在 Azure 静态 Web 应用上托管
    • 在 Cloudflare Pages 上托管
    • 在 Firebase 上托管
    • 在 GitHub Pages 上托管
    • 在 GitLab Pages 上托管
    • 在 KeyCDN 上托管
    • 在 Netlify 上托管
    • 在 Render 上托管
  • 贡献
    • 本节内容
    • 开发
    • 文档
    • 主题
  • 维护
安装

BSD

在 BSD 衍生版本上安装 Hugo。

版本

Hugo 提供三个版本:标准版、扩展版和扩展/部署版。标准版提供核心功能,而扩展版和扩展/部署版提供高级功能。

功能 扩展版 扩展/部署版
在处理图像时,编码为 WebP 格式。 您可以使用任何版本解码 WebP 图像。 ✔️ ✔️
使用嵌入式 LibSass 转译器将 Sass 转译为 CSS。 您可以使用任何版本的 Dart Sass 转译器。 ✔️ ✔️
将您的站点直接部署到 Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器。 请参阅详细信息。 ❌ ✔️

除非您的特定部署需求需要扩展/部署版,否则我们建议使用扩展版。

先决条件

虽然并非在所有情况下都必需,但在使用 Hugo 时,通常会使用Git、Go和Dart Sass。

Git 是必需的,用于:

  • 从源代码构建 Hugo
  • 使用Hugo 模块功能
  • 将主题安装为 Git 子模块
  • 从本地 Git 存储库访问提交信息
  • 使用 CloudCannon、Cloudflare Pages、GitHub Pages、GitLab Pages 和 Netlify 等服务托管您的站点

Go 是必需的,用于:

  • 从源代码构建 Hugo
  • 使用 Hugo 模块功能

当使用 Sass 语言的最新功能时,需要使用 Dart Sass 将 Sass 转译为 CSS。

请参阅相关文档以获取安装说明

  • Git
  • Go
  • Dart Sass

预构建二进制文件

预构建的二进制文件可用于各种操作系统和架构。访问最新版本页面,并向下滚动到“Assets”部分。

  1. 下载所需版本、操作系统和架构的存档
  2. 提取存档
  3. 将可执行文件移动到所需的目录
  4. 将此目录添加到 PATH 环境变量
  5. 验证您是否对该文件具有执行权限

如果您需要帮助设置文件权限或修改 PATH 环境变量,请查阅您的操作系统文档。

如果您没有看到所需版本、操作系统和架构的预构建二进制文件,请使用下面描述的方法之一安装 Hugo。

存储库软件包

大多数 BSD 衍生版本都维护一个常用安装应用程序的存储库。请注意,这些存储库可能不包含最新版本。

DragonFly BSD

DragonFly BSD在其软件包存储库中包含 Hugo。要安装扩展版的 Hugo

sudo pkg install gohugo

FreeBSD

FreeBSD在其软件包存储库中包含 Hugo。要安装扩展版的 Hugo

sudo pkg install gohugo

NetBSD

NetBSD在其软件包存储库中包含 Hugo。要安装扩展版的 Hugo

sudo pkgin install go-hugo

OpenBSD

OpenBSD在其软件包存储库中包含 Hugo。这将提示您选择要安装的 Hugo 版本

doas pkg_add hugo

从源代码构建

要从源代码构建扩展版或扩展/部署版,您必须:

  1. 安装Git
  2. 安装Go 1.20 或更高版本
  3. 安装 C 编译器,可以是 GCC 或 Clang
  4. 按照Go 文档中的描述更新您的 PATH 环境变量

安装目录由 GOPATH 和 GOBIN 环境变量控制。如果

构建标准版

go install github.com/gohugoio/hugo@latest

构建扩展版

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

构建扩展/部署版

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

比较

预构建二进制文件 仓库包 从源代码构建
易于安装? ✔️ ✔️ ✔️
易于升级? ✔️ 各不相同 ✔️
易于降级? ✔️ 各不相同 ✔️
自动更新? ❌ 各不相同 ❌
提供最新版本? ✔️ 各不相同 ✔️

另请参阅

  • Linux
  • Windows
  • macOS
  • 摘要
  • 开发

本页内容

  • 版本
  • 先决条件
  • 预构建二进制文件
  • 仓库包
  • 从源代码构建
  • 比较
最后更新:2024年11月2日:描述并引用扩展/部署版(3744f3be2)
改进此页面
由Hugo作者编写
Hugo Logo
  • 提交问题
  • 获取帮助
  • @GoHugoIO
  • @spf13
  • @bepsays

Netlify badge

 

Hugo赞助商

您的公司?
 

Hugo标志的版权归Steve Francia所有,2013–2025年。

Hugo Gopher基于Renée French的原创作品。

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
  • 关于
  • 安装
  • 入门
  • 快速参考
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 渲染钩子
  • 简码
  • Hugo 模块
  • Hugo Pipes
  • CLI
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护