欢迎来到 Hugo 的世界！Hugo 是一个用 Go 语言编写的、速度极快的静态网站生成器。本指南将手把手教您如何在 Linux 系统上完成 Hugo 的安装，即使您是第一次接触命令行，也能轻松上手。

第一部分：安装必需的依赖项

在安装 Hugo 之前，我们需要确保系统中有一些基础工具。

1. Git 版本控制工具

Git 用于管理主题和代码版本，是使用 Hugo 的必备工具。

安装方法：

打开您的终端，根据您的 Linux 发行版输入以下命令：

• 对于 Debian/Ubuntu 系统 (如 Ubuntu, Mint):

  1 2	sudo apt update sudo apt install git -y

• 对于 RHEL/CentOS/Fedora 系统:

  1 2 3

  sudo dnf install git -y # 或者在旧版系统上使用 yum # sudo yum install git -y

验证安装： 输入 git --version，如果看到类似 git version 2.34.1 的输出，说明 Git 已成功安装。

2. Go 语言环境 (可选，但推荐)

虽然直接安装 Hugo 的二进制文件不需要 Go，但如果您想从源码编译或未来进行更深入的开发，安装 Go 是一个好习惯。

安装方法 (以 Ubuntu 为例):

1
2

sudo apt update
sudo apt install golang-go -y

验证安装： 输入 go version，如果看到类似 go version go1.18.1 linux/amd64 的输出，说明 Go 已成功安装。

第二部分：安装 Hugo（选择一种方式即可）

我们提供两种安装方式，强烈推荐第一种，因为它最简单。

方式一：使用包管理器安装 (最推荐)

这是最适合新手的安装方式，简单、快速且易于管理。

• 对于 Debian/Ubuntu 系统:

  1 2	sudo apt update sudo apt install hugo -y

• 对于 RHEL/CentOS/Fedora 系统:

  1	sudo dnf install hugo -y

注意：通过这种方式安装的版本可能不是最新的。但对于入门来说，完全足够。

方式二：手动下载二进制文件 (获取最新版)

如果您想体验 Hugo 的最新功能，可以选择手动安装。

1. 下载 Hugo 安装包: 前往 Hugo 的 GitHub Releases 页面 找到最新版本。寻找名为 hugo_extended_..._Linux-64bit.tar.gz 的文件。extended 版本支持更多功能，是我们的首选。

   右键点击该文件，选择“复制链接地址”，然后在终端中使用 wget 命令下载它。例如：

   1 2	# 注意：请将下面的链接替换为您在 GitHub 上复制的最新版本链接 wget https://github.com/gohugoio/hugo/releases/download/v0.129.0/hugo_extended_0.129.0_Linux-64bit.tar.gz

2. 解压文件: 使用 tar 命令解压刚刚下载的文件。

   1 2	# 同样，请确保文件名与您下载的一致 tar -xvf hugo_extended_0.129.0_Linux-64bit.tar.gz

   解压后，您会得到一个名为 hugo 的可执行文件。

3. 移动文件到系统路径: 为了能在任何目录下都能使用 hugo 命令，我们需要将这个文件移动到一个位于系统 PATH 环境变量中的目录。/usr/local/bin 是一个绝佳的选择。

   1	sudo mv hugo /usr/local/bin/

第三部分：验证安装是否成功

无论您使用哪种方式安装，最后的验证步骤都是相同的。

1. 检查版本: 在终端中输入：

   1	hugo version

   预期输出：您应该能看到类似 hugo v0.129.0-extended linux/amd64 BuildDate=... 的信息。看到 extended 字样表示您安装的是功能更全的扩展版，非常棒！

2. 构建一个简单站点进行测试: 让我们快速创建一个测试站点，确保 Hugo 能正常工作。

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

   # 1. 创建一个新站点 hugo new site my-test-site # 2. 进入新站点的目录 cd my-test-site # 3. 初始化 Git 仓库 git init # 4. 添加一个主题（这里以 Ananke 为例） git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke # 5. 告诉 Hugo 使用这个主题 echo "theme = 'ananke'" >> hugo.toml # 6. 创建您的第一篇文章 hugo new posts/hello-world.md # 7. 构建网站！ hugo

   预期输出：命令执行后，您会看到类似 Total in ... ms 的成功信息。此时，运行 ls 命令，您应该能看到一个新生成的 public 目录。这个目录里就是您网站的所有静态文件。

第四部分：新手常见问题 (FAQ)

• Q: 输入 hugo version 后，提示 command not found 怎么办？ A: 这通常意味着 Hugo 没有被正确安装到系统的 PATH 路径中。如果您是手动安装的，请回到方式二的第3步，确保您已将 hugo 文件移动到了 /usr/local/bin/。

• Q: “standard” 和 “extended” 版本有什么区别？ A: extended 版本内置了对 SCSS/SASS（一种更强大的 CSS 预处理器）的支持。现在绝大多数现代主题都依赖这个功能。因此，请始终优先选择并安装 extended 版本。

• Q: 如何更新 Hugo？ A: 如果您是通过包管理器安装的，运行系统的更新命令即可（如 sudo apt upgrade）。如果您是手动安装的，只需重复方式二的步骤，下载新版本并覆盖旧的 /usr/local/bin/hugo 文件即可。

恭喜您！现在您的 Linux 系统已经拥有了强大的 Hugo 工具，快去开启您的博客之旅吧！