Linux

版本

Hugo 提供具有核心功能的标准版，以及具有更多功能的 extended 和 extended/deploy 版。除非您需要以下功能，否则请使用标准版。

前提条件

虽然在某些情况下不需要，但 Git、Go 和 Dart Sass 在使用 Hugo 时很常见。

Git 是必需的：

• 从源码构建 Hugo
• 使用 Hugo Modules 功能
• 将主题安装为 Git 子模块
• 从本地 Git 仓库访问 提交信息
• 在 CI/CD 平台上托管您的站点，如 Cloudflare、GitHub Pages、GitLab Pages、Netlify、Render 或 Vercel

Go 是必需的：

• 从源码构建 Hugo
• 使用 Hugo Modules 功能

Dart Sass 是使用最新 Sass 语言功能时将 Sass 转译为 CSS 所必需的。

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

• Git
• Go
• Dart Sass

预编译二进制文件

预编译二进制文件适用于各种操作系统和架构。访问 最新发行版 页面，向下滚动到 Assets 部分。

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

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

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

包管理器

Homebrew

Homebrew 是 macOS 和 Linux 的免费开源包管理器。安装 extended/deploy 版的 Hugo：

brew install hugo

仓库包

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

Alpine Linux

在 Alpine Linux 上安装 extended 版的 Hugo：

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

Arch Linux

Arch Linux 发行版的衍生版包括 EndeavourOS、Garuda Linux、Manjaro 等。安装 extended 版的 Hugo：

sudo pacman -S hugo

Debian

Debian 发行版的衍生版包括 elementary OS、KDE neon、Linux Lite、Linux Mint、MX Linux、Pop!_OS、Ubuntu、Zorin OS 等。安装 extended 版的 Hugo：

sudo apt install hugo

您也可以从 最新发行版 页面下载 Debian 包。

Exherbo

在 Exherbo 上安装 extended 版的 Hugo：

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

   www-apps/hugo extended

2. 使用 Paludis 包管理器安装：

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

Fedora

Fedora 发行版的衍生版包括 CentOS、Red Hat Enterprise Linux 等。安装 extended 版的 Hugo：

sudo dnf install hugo

Gentoo

Gentoo 发行版的衍生版包括 Calculate Linux、Funtoo 等。安装 extended 版的 Hugo：

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

   www-apps/hugo extended

2. 使用 Portage 包管理器构建：

   sudo emerge www-apps/hugo

NixOS

NixOS 发行版在其软件包仓库中包含 Hugo。安装 extended 版的 Hugo：

nix-env -iA nixos.hugo

openSUSE

openSUSE 发行版的衍生版包括 GeckoLinux、Linux Karmada 等。安装 extended 版的 Hugo：

sudo zypper install hugo

Solus

Solus 发行版在其软件包仓库中包含 Hugo。安装 extended 版的 Hugo：

sudo eopkg install hugo

Void Linux

在 Void Linux 上安装 extended 版的 Hugo：

sudo xbps-install -S hugo

从源码构建

要从源码构建 extended 或 extended/deploy 版，您必须：

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

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

构建标准版：

go install github.com/gohugoio/hugo@latest

构建 extended 版：

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

构建 extended/deploy 版：

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

比较