HUGO 中文文档

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
gohugoio Star
  • 关于
    • 本节内容
    • 简介
    • 特性
    • 隐私
    • 安全
    • 许可证
  • 安装
    • 本节内容
    • macOS
    • Linux
    • Windows
    • BSD
  • 快速上手
    • 本节内容
    • 快速入门
    • 基本用法
    • 目录结构
    • 配置
    • 配置标记
    • 术语表
    • 配置构建
    • 外部学习资源
  • 快速参考
    • 本节内容
    • 表情符号
    • 函数
    • 方法
    • 页面集合
  • 内容管理
    • 本节内容
    • 组织
    • 页面包
    • 内容格式
    • Front matter (前置 matter)
    • 构建选项
    • 页面资源
    • 图片处理
    • 短代码
    • 相关内容
    • 章节
    • 内容类型
    • 原型
    • 分类法
    • 摘要
    • 链接和交叉引用
    • URL 管理
    • 菜单
    • 评论
    • 多语言
    • Markdown 属性
    • 语法高亮
    • 图表
    • 数学公式
    • 数据源
    • 内容适配器
  • 模板
    • 本节内容
    • 简介
    • 模板类型
    • 查找顺序
    • 基模板
    • 首页模板
    • 单个模板
    • 章节模板
    • 分类模板
    • 术语模板
    • 局部模板
    • 内容视图模板
    • 短代码模板
    • 站点地图模板
    • RSS 模板
    • 404 模板
    • robots.txt 模板
    • 菜单
    • 分页
    • 内嵌模板
    • 自定义输出格式
  • 函数
    • 本节内容
    • css
    • fmt
    • go 模板
    • hugo
    • js
    • lang
    • openapi3
    • os
    • urls
    • 全局
    • 加密
    • 反射
    • 变形
    • 变换
    • 哈希
    • 图像
    • 图表函数
    • 字符串
    • 安全函数
    • 局部模板函数
    • 数学
    • 数据
    • 时间
    • 模板
    • 比较
    • 类型转换
    • 编码
    • 调试
    • 资源
    • 路径
    • 集合
  • 方法
    • 本节内容
    • Duration
    • Menu
    • Page
    • Pager
    • Resource
    • Shortcode
    • Site
    • Taxonomy
    • Time
    • 菜单项
    • 页面
  • 渲染钩子
    • 本节内容
    • 简介
    • 块引用
    • 代码块
    • 标题
    • Images
    • 链接
    • Passthrough
    • 表格
  • Hugo 模块
    • 本节内容
    • 配置 Hugo 模块
    • 使用 Hugo 模块
    • 主题组件
  • Hugo 管道
    • 本节内容
    • 简介
    • 将 Sass 编译为 CSS
    • PostCSS
    • PostProcess
    • JavaScript 构建
    • 资源压缩
    • 连接资产
    • 指纹和 SRI 哈希
    • 从字符串创建资源
    • 从模板创建资源
  • 命令行界面
  • 故障排除
    • 本节内容
    • Audit
    • 日志记录
    • 检查
    • 弃用
    • 性能
    • FAQs
  • 开发者工具
    • 本节内容
    • 编辑器插件
    • 前端
    • Search
    • 迁移
    • 其他项目
  • 托管和部署
    • 本节内容
    • Hugo 部署
    • 使用 Rclone 部署
    • 使用 Rsync 部署
    • 在 21YunBox 上托管
    • 在 AWS Amplify 上托管
    • 在 Cloudflare Pages 上托管
    • 在 Firebase 上托管
    • 在 GitLab Pages 上托管
    • 在 Netlify 上托管
    • 在 Render 上托管
    • 托管在 Azure 静态 Web 应用上
    • 托管在 GitHub Pages 上
    • 托管在 KeyCDN 上
  • 贡献
    • 本节内容
    • 开发
    • 文档
    • 主题
  • 维护
INSTALLATION

Linux

在 Linux 上安装 Hugo。

版本

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

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

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

预备条件

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

Git 用于:

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

Go 用于:

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

Dart Sass 用于在使用 Sass 语言的最新功能时将 Sass 编译成 CSS。

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

  • Git
  • Go
  • Dart Sass

预构建二进制文件

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

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

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

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

包管理器

Snap

Snap 是一个免费的开源 Linux 包管理器。适用于 大多数发行版 ,Snap 包易于安装且会自动更新。

Hugo Snap 包是 严格限制的 。严格限制的 Snap 在完全隔离的环境中运行,访问级别最低,被认为始终安全。您创建和构建的站点必须位于您的主目录或可移动介质中。

要安装 Hugo 的扩展版:

sudo snap install hugo

要启用或撤销对可移动介质的访问:

sudo snap connect hugo:removable-media
sudo snap disconnect hugo:removable-media

要启用或撤销对 SSH 密钥的访问:

sudo snap connect hugo:ssh-keys
sudo snap disconnect hugo:ssh-keys

Homebrew

Homebrew 是一个适用于 macOS 和 Linux 的免费开源包管理器。要安装 Hugo 扩展版,请执行以下操作:

brew install hugo

仓库包

大多数 Linux 发行版都维护着一个用于常用应用程序的仓库。

包仓库中提供的 Hugo 版本因 Linux 发行版和版本而异,在某些情况下并非 最新版本 。

如果您的包仓库没有提供所需的版本,请使用其他安装方法之一。

Alpine Linux

要在 Alpine Linux 上安装 Hugo 的扩展版:

doas apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/community hugo

Arch Linux

Arch Linux Linux 发行版的派生版包括 EndeavourOS 、 Garuda Linux 、 Manjaro 等。要安装 Hugo 的扩展版:

sudo pacman -S hugo

Debian

Debian Linux 发行版的派生版包括 elementary OS 、 KDE neon 、 Linux Lite 、 Linux Mint 、 MX Linux 、 Pop!_OS 、 Ubuntu 、 Zorin OS 等。要安装 Hugo 的扩展版:

sudo apt install hugo

您也可以从 [最新版本] 页面下载 Debian 包。

Exherbo

要在 Exherbo 上安装 Hugo 的扩展版:

  1. 将此行添加到 /etc/paludis/options.conf:

    www-apps/hugo extended
    
  2. 使用 Paludis 包管理器安装:

    cave resolve -x repository/heirecka
    cave resolve -x hugo
    

Fedora

Fedora Linux 发行版的派生版包括 CentOS 、 Red Hat Enterprise Linux 等。要安装 Hugo 的扩展版:

sudo dnf install hugo

Gentoo

Gentoo Linux 发行版的派生版包括 Calculate Linux 、 Funtoo 等。要安装 Hugo 的扩展版:

  1. 在 /etc/portage/package.use/hugo 中指定 extended USE 标志:

    www-apps/hugo extended
    
  2. 使用 Portage 包管理器构建:

    sudo emerge www-apps/hugo
    

NixOS

NixOS Linux 发行版在其包仓库中包含 Hugo。要安装 Hugo 的扩展版:

nix-env -iA nixos.hugo

openSUSE

openSUSE Linux 发行版的派生版包括 GeckoLinux 、 Linux Karmada 等。要安装 Hugo 的扩展版:

sudo zypper install hugo

Solus

Solus Linux 发行版在其包仓库中包含 Hugo。要安装 Hugo 的扩展版:

sudo eopkg install hugo

Void Linux

要在 Void Linux 上安装 Hugo 的扩展版:

sudo xbps-install -S hugo

从源码构建

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

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

安装目录由 GOPATH 和 GOBIN 环境变量控制。如果设置了 GOBIN ,则二进制文件将安装到该目录。如果设置了 GOPATH ,则二进制文件将安装到 GOPATH 列表中第一个目录的 bin 子目录。否则,二进制文件将安装到默认 GOPATH ($HOME/go 或 %USERPROFILE%\go) 的 bin 子目录。

要构建标准版:

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

对比

预构建二进制文件 包管理器 仓库包 从源代码构建
易于安装? ✔️ ✔️ ✔️ ✔️
易于升级? ✔️ ✔️ 有所不同 ✔️
易于降级? ✔️ ✔️ 1(Easy) 有所不同 ✔️
自动更新? ❌ 有所不同 2(Snap) ❌ ❌
提供最新版本? ✔️ ✔️ 有所不同 ✔️

  1. 如果先前版本仍然已安装则很容易。 ↩︎

  2. Snap 包会自动更新。Homebrew 需要高级配置。 ↩︎

See also

  • macOS
  • BSD
  • Windows
  • Git信息
  • css.TailwindCSS

On this page

  • 版本
  • 预备条件
  • 预构建二进制文件
  • 包管理器
  • 仓库包
  • 从源码构建
  • 对比
Last updated: January 10, 2025: 添加 gtm 谷歌代码管理 (6220bf5)
Improve this page
By the Hugo Authors
Hugo Logo
  • File an Issue
  • Get Help
  • @GoHugoIO
  • @spf13
  • @bepsays
 

Hugo Sponsors

Your Company?
 

The Hugo logos are copyright © Steve Francia 2013–2025.

The Hugo Gopher is based on an original work by Renée French.

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
  • 关于
  • 安装
  • 快速上手
  • 快速参考
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 渲染钩子
  • Hugo 模块
  • Hugo 管道
  • 命令行界面
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护