在 macOS 上安装

发行版（edition）

Hugo 提供多个发行版（edition）。除非需要额外功能，否则使用 standard 版即可。

1. deploy 版自 v0.159.2 起提供。
2. 把站点直接部署到 Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器，详见用 hugo deploy 部署。
3. 通过内置的 LibSass 把 Sass 转译为 CSS。内置 LibSass 已在 v0.153.0 中弃用，并将在未来版本中移除，请改用任何 edition 都可用的 Dart Sass 转译器。

前置依赖（prerequisites）

Git、Go、Dart Sass 在 Hugo 的日常使用中很常见，但并非所有场景都需要。

Git 用于：

• 从源码构建 Hugo
• 使用 Hugo 模块
• 以 Git 子模块（Git submodule）方式安装主题
• 从本地 Git 仓库获取提交信息
• 把站点托管到 Cloudflare、GitHub Pages、GitLab Pages、Netlify、Render、Vercel 等 CI/CD（持续集成与持续交付）平台，详见托管与部署

Go 用于：

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

使用 Sass 语言的最新特性时，需要用 Dart Sass 把 Sass 转译为 CSS。

安装方法请查阅各自的文档：

• 安装 Git
• 安装 Go
• 安装 Dart Sass

预编译二进制（prebuilt binaries）

官方为各种操作系统与架构提供了预编译二进制文件。请访问 Hugo 的最新发布页面，向下滚动到 Assets 部分。

1. 下载所需 edition、操作系统与架构对应的压缩包
2. 解压
3. 把可执行文件移动到目标目录
4. 把该目录加入 PATH 环境变量
5. 确认对该文件有_执行_权限

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

如果找不到所需 edition、操作系统与架构的预编译二进制，请改用下面介绍的安装方式。

包管理器（package manager）

也可以用下列包管理器安装 Hugo。

Homebrew

Homebrew 是 macOS 与 Linux 上自由开源的包管理器。安装 extended/deploy 版的 Hugo：

brew install hugo

MacPorts

MacPorts 是 macOS 上自由开源的包管理器。安装 extended 版的 Hugo：

sudo port install hugo

从源码构建

从源码构建 Hugo 需要先安装：

1. Git
2. Go，版本不低于当前 Hugo 所要求的 Go 版本

Standard 版

构建并安装 standard 版：

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

Deploy 版

构建并安装 deploy 版：

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

Extended 版

构建并安装 extended 版，需要先安装 C 编译器，例如 GCC 或 Clang，然后执行：

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

Extended/deploy 版

构建并安装 extended/deploy 版，需要先安装 C 编译器，例如 GCC 或 Clang，然后执行：

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

验证安装与升级

安装完成后，在终端中执行：

hugo version

命令会输出 Hugo 的版本、edition 与构建信息。如果提示找不到命令，说明可执行文件所在目录还没有加入 PATH 环境变量，请参考上面的预编译二进制步骤或查阅系统文档。

升级方式取决于你使用的安装方式：Homebrew 可以用 brew upgrade hugo 升级，它安装的是 extended/deploy 版；MacPorts 安装的包用 MacPorts 自身的升级流程；从源码构建时，重新执行对应的 go install 命令即可。自动更新并非默认行为，Homebrew 需要额外配置才能自动升级，从源码构建则完全依赖你手动重新执行命令。

对比

• 包管理器降级：如果旧版本仍然保留在系统中，降级很容易。
• 包管理器自动更新：可以实现，但需要额外配置。