当前位置：首页 > article >正文

HUGO介绍、安装、以及使用

article 2025/3/22 15:45:30

HUGO官方网站，文章内容的简介大部分来自官网的翻译，官网是纯英文描述，英语好的可以前往官方网站，博主在这里简介中简单翻译处理包括一些链接的引用，主要是讲解一下如何安装和使用。

这里再粘贴一个三方网站opendocs.io的HUGO官方网站英文版的翻译网站

简介（取自HUGO官网）：

一个快速灵活的静态站点生成器，由bep、spf13和Go的friends精心构建。

Hugo 是一个用Go编写的静态网页生成器，可以在几秒钟内（通常更短）呈现完整的网站。

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

企业、政府、非营利组织、教育、新闻、活动和项目网站
文档站点
图片集
登陆页面
商业、专业和个人博客
简历和履历

在开发过程中使用 Hugo 的嵌入式 Web 服务器可以即时查看内容、结构、行为和演示的更改。然后将网站部署到您的主机，或将更改推送到您的 Git 提供程序以进行自动构建和部署。

Hugo 的快速资产管道包括：

图像处理——转换、调整大小、裁剪、旋转、调整颜色、应用过滤器、叠加文本和图像以及提取 EXIF 数据
JavaScript 捆绑——将 TypeScript 和 JSX 转换为 JavaScript、捆绑、树形摇动、最小化、创建源映射并执行 SRI 散列。
Sass 处理 - 将 Sass 转换为 CSS、捆绑、树摇、最小化、创建源映射、执行 SRI 哈希以及与 PostCSS 集成
Tailwind CSS 处理 - 将 Tailwind CSS 实用程序类编译为标准 CSS、捆绑、树摇、优化、最小化、执行 SRI 哈希并与 PostCSS 集成

使用Hugo 模块，您可以通过公共或私有 Git 存储库与其他项目共享内容、资产、数据、翻译、主题、模板和配置。

请参阅文档的功能部分，以获得 Hugo 功能的全面摘要。

一、版本介绍

hugo有三个版本标准版、拓展版、拓展/部署版

推荐安装拓展版本

1、Hugo 标准版

适合 一般的 Hugo 站点，如果不需要 SCSS/SASS 处理，可以使用。
仅支持纯 HTML/CSS/JS，不能编译 SASS/SCSS，也 不支持 PostCSS。
运行速度快，适用于 轻量级博客或文档站点。
适用场景：
- 纯 Markdown 转 HTML
- 个人博客、技术文档网站
- 没有复杂的前端需求

执行命令：hugo version

显示类似：
hugo v0.145.0 linux/amd64 BuildDate=unknown

2、Hugo 拓展版（Extended）

支持 SCSS/SASS 编译（Hugo Pipes）
支持 PostCSS 处理
适用于 需要前端优化、CSS 预处理、优化静态资源的站点
是标准版的超集（包含标准版的所有功能）
适用场景：
- 需要使用 SCSS/SASS 预处理 CSS
- 需要 Tailwind CSS、Autoprefixer
- 希望 Hugo 直接优化 CSS/JS 资源

执行命令：hugo version

显示类似：
hugo v0.145.0+extended linux/amd64 BuildDate=unknown

3、Hugo 开发版（Dev/HEAD）

最新 Hugo 开发中的版本，包含 Hugo 团队最新的功能和改进
可能有新特性，但不稳定，不推荐用于生产环境
适合 Hugo 主题和插件开发者测试最新功能
适用场景：
- 需要 Hugo 的最新功能
- 参与 Hugo 社区贡献
- 主题开发者或高级用户

执行命令：hugo version

显示类似：
hugo v0.145.0+extended,withdeploy linux/amd64 BuildDate=unknown

4、比对表

版本	适合谁？	是否支持 SCSS/SASS	是否支持 Hugo Pipes	是否支持 `hugo deploy`
Standard（标准版）	轻量级 Hugo 用户	❌ 否	❌ 否	❌ 否
Extended（拓展版）	推荐大多数用户使用	✅ 是	✅ 是	❌ 否
With Deploy（带部署版）	需要 Hugo 直接部署的用户	✅ 是	✅ 是	✅ 是

二、安装（Linux、Windows、Mac）

再强调一遍推荐安装拓展版，因为大部分模板都需要Sass等其他处理

1、源代码构建（通用于任何平台）

**注意：**源代码构建可以忽略GCC这个点，一般情况下源代码构建是一些较低的版本不支持，像hugo0.56.0这种远古版本，新版本都没什么问题。

前置条件，Linux、Windows、Mac中必须安装go编译器，参照如下：

标准版：Go 1.23.0 或更高版本
扩展版：Go 1.23.0 或更高版本，以及 GCC
扩展/部署版本：Go 1.23.0 或更高版本，以及 GCC

构建标准版

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

检查是否安装成功

hugo version
# 显示版本信息即安装成功，类似如下内容：
hugo v0.145.0+extended,withdeploy linux/amd64 BuildDate=unknown

2、二进制文件安装（通用于任何平台）

推荐使用最新版本，下载链接

1.Linux安装（要区分arm和amd）

amd架构：**x86_64 (AMD64)**适用于基于 Intel 和 AMD 的 64位处理器

arm架构：aarch64适用于 ARM64 架构的处理器（例如树莓派或其他 ARM 设备）

使用命令：uname -m 即可查看架构；如下CentOS/Ubuntu比较常用的，其它也是按照这两种方式

CentOS
- Linux下载类似这种名称（extended代表扩展版本）：
  - amd架构：hugo_extended_0.145.0_linux-amd64.tar.gz
  - arm架构：hugo_extended_withdeploy_0.145.0_linux-arm64.tar.gz
- 下载命令：wget https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_0.145.0_linux-amd64.tar.gz
- 解压：tar -zxvf hugo_extended_0.145.0_linux-amd64.tar.gz
- 切换路径：cd hugo_extended_0.145.0_linux-amd64
- 移动到目录/usr/local/bin/下：sudo mv hugo /usr/local/bin/
- 检查安装，终端输入：hugo version
- 显示版本信息成功，即安装完成，显示信息类似如下：
  
  hugo v0.145.0+extended linux/amd64 BuildDate=unknown
Ubuntu
- Linux下载类似这种名称（extended代表扩展版本）：
  - amd架构：hugo_extended_withdeploy_0.145.0_linux-amd64.deb
  - arm架构：hugo_extended_withdeploy_0.145.0_linux-arm64.deb
- 下载命令：wget https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_withdeploy_0.145.0_linux-amd64.deb
- 下载安装dpkg（如果存在可省略此步骤-左侧是Ubuntu命令）
  - sudo apt-get update
  - sudo apt-get install dpkg
- 安装命令：sudo dpkg -i hugo_extended_withdeploy_0.145.0_linux-amd64.deb
- 检查安装，终端输入：hugo version
- 显示版本信息成功，即安装完成，显示信息类似如下：
  
  hugo v0.145.0+extended linux/amd64 BuildDate=unknown

2.Windows安装

Windows下载类似这种名称（extended代表扩展版本）：hugo_extended_withdeploy_0.145.0_windows-amd64.zip
官网下载，下载后解压压缩包，进入到目录hugo_extended_withdeploy_0.145.0_windows-amd64，复制hugo文件所在的路径例如D:\SoftFile\hugo_extended_0.145.0_Windows-64bit\
配置环境变量
- **Win11位置：**系统 > 系统信息 > 高级系统设置 > 环境变量(N)… > 系统变量(S)
- 找到Path变量，添加新的环境变量D:\SoftFile\hugo_extended_0.145.0_Windows-64bit\
检查安装，终端输入：hugo versiion
显示版本信息成功，即安装完成，显示信息类似如下：

hugo v0.145.0+extended linux/amd64 BuildDate=unknown

3.Mac安装

Mac下载类似这种名称（extended代表扩展版本）：hugo_extended_withdeploy_0.145.0_darwin-universal.tar.gz
直接下载或者命令下载，下载命令：wget https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_withdeploy_0.145.0_darwin-universal.tar.gz 或 curl -LO https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_withdeploy_0.145.0_darwin-universal.tar.gz
解压：tar -xvzf hugo_extended_withdeploy_0.145.0_darwin-universal.tar.gz
切换路径：cd hugo_extended_withdeploy_0.145.0_darwin-universal
移动到目录/usr/local/bin/下：sudo mv hugo /usr/local/bin/
检查安装，终端输入：hugo version
显示版本信息成功，即安装完成，显示信息类似如下：

hugo v0.145.0+extended linux/amd64 BuildDate=unknown

3、系统命令安装

除了Mac，强烈建议使用上面两种方式安装；至于为什么，因为有坑，而且是大坑，这里就涉及到文章开头提到的GCC，再就是版本问题，下面会讲解到。

例如：centos的yum，Ubuntu的apt-get，Mac常用的Homebrew

1.CentOS

安装启用 EPEL 仓库，Hugo 需要从 EPEL（Extra Packages for Enterprise Linux） 仓库安装，因此如果系统没有启用 EPEL，先运行以下命令：sudo yum install epel-release -y
更新仓库：sudo yum update -y
下载安装（默认标准版）：sudo yum install hugo -y
检查安装，终端输入：hugo version
显示版本信息成功，即安装完成，显示信息类似如下：

hugo v0.145.0 linux/amd64 BuildDate=unknown