qidao123.com技术社区-IT企服评测·应用市场

标题: HUGO介绍、安装、以及使用 [打印本页]

作者: 火影 时间: 2025-3-21 17:54
标题: HUGO介绍、安装、以及使用
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
- 1. 显示类似：
  2. 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
- 1. 显示类似：
  2. hugo v0.145.0+extended linux/amd64 BuildDate=unknown
  复制代码

3、Hugo 开发版（Dev/HEAD）

最新 Hugo 开发中的版本，包含 Hugo 团队最新的功能和改进
可能有新特性，但不稳定，不推荐用于生产情况
适合 Hugo 主题和插件开发者测试最新功能
适用场景：
- 需要 Hugo 的最新功能
- 到场 Hugo 社区贡献
- 主题开发者或高级用户
执行下令：hugo version
- 1. 显示类似：
  2. hugo v0.145.0+extended,withdeploy linux/amd64 BuildDate=unknown
  复制代码

4、比对表

版本适合谁？是否支持 SCSS/SASS是否支持 Hugo Pipes是否支持 hugo deployStandard（标准版）轻量级 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

注意：如果是CentOS 7，百分百会报错，因为官网下载的CentOS 7版本的GCC 都在 5 以下，版本太低了，这时候就需要手动安装GCC了，是不支持直接下令升级的，由此会引发一堆须要的不须要的问题。
2.Ubuntu

更新apt-get：sudo apt-get update
下载安装（默认标准版）：sudo apt-get install hugo -y
检查 Hugo 版本：hugo version
显示版本信息成功，即安装完成，显示信息类似如下：
hugo v0.145.0 linux/amd64 BuildDate=unknown

注意：使用 apt-get install 方式安装的 Hugo 版本通常较旧，并且是 标准版，不支持 SCSS/SASS。
3.Mac

在 macOS 上，使用 Homebrew 安装 Hugo 是最简朴的方法。Homebrew 默认安装的是 Extended 版本，支持 SCSS/SASS 处理，非常推荐！

更新 Homebrew：brew update
下载安装（默认拓展版Extended）：brew install hugo
检查 Hugo 版本：hugo version
显示版本信息成功，即安装完成，显示信息类似如下：
hugo v0.145.0 linux/amd64 BuildDate=unknown

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

欢迎光临 qidao123.com技术社区-IT企服评测·应用市场 (https://dis.qidao123.com/)