将Hugo部署到Ubuntu

Posted on May 21, 2025

阅读 | 共394字，阅读约 2 分钟

如果通过 apt 安装的 Hugo 版本较旧，而 snap 提供的是最新版本，可通过以下方案解决版本差异问题：

一、为什么 apt 版本比 snap 旧？

  1. 仓库更新机制不同：

    • apt 依赖 Ubuntu 官方仓库，版本更新需经过严格测试，通常滞后于官方最新版4。
    • snap 由开发者直接维护，更新频率更高（如 Hugo 扩展版包含最新功能）2。

  2. 功能支持差异：

    • apt 默认安装 标准版 Hugo（无 Sass/SCSS 支持），而 snap 提供 扩展版（含 LibSass 转译器）

二、解决方案：优先使用 snap 最新版

步骤 1：卸载旧版 Hugo（apt 安装的）

sudo apt remove -y hugo

步骤 2：通过 snap 安装扩展版 Hugo

sudo snap install hugo --channel=extended/stable

验证安装

hugo version
# 输出应包含 "extended" 标识，例如：
# hugo v0.147.4+extended linux/amd64 BuildDate=2024-05-15T12:34:56Z

步骤 3：彻底移除 apt 残留（可选）

sudo apt autoremove --purge hugo

三、替代方案：手动下载最新版二进制文件

若坚持使用 apt 或需要完全控制版本，可手动下载官方最新版：

步骤 1：下载扩展版 .deb 包

访问 Hugo 官方 Releases，选择适用于 Linux 64 位的扩展版（文件名含 extended）。 命令行示例（以 v0.147.4 为例）：

wget https://github.com/gohugoio/hugo/releases/download/v0.147.4/hugo_extended_0.147.4_Linux-64bit.deb

步骤 2：安装 .deb 包

sudo dpkg -i hugo_extended_0.147.4_Linux-64bit.deb

步骤 3：验证版本

hugo version

四、为什么必须使用扩展版？

  • 主题兼容性： 许多 Hugo 主题（如 hugo-serif）依赖 Sass/SCSS 预处理，标准版 Hugo 无法编译此类文件10。
  • 功能支持： 扩展版包含 LibSass 转译器，可直接处理 CSS 预处理，无需额外安装 Dart Sass5。

五、其他注意事项

  1. 自动更新：

    安装的 Hugo 会自动更新至最新版：

    sudo snap refresh hugo

    apt需手动更新（版本可能仍落后）：

    sudo apt update && sudo apt upgrade hugo

  2. 扩展版与标准版共存：

    • 若同时安装snap和apt版本，snap优先级更高，可通过以下命令切换：

      # 查看当前使用的 Hugo 路径
which hugo

# 强制使用 apt 版本（不推荐）
sudo update-alternatives --config hugo

  3. 避免依赖冲突：

    • 彻底卸载 apt 版本后，snap 版本将完全替代，避免因版本混杂导致的问题4。

总结

  • 推荐方案：通过 snap install hugo --channel=extended/stable 安装最新扩展版，自动解决版本和功能问题。
  • 备用方案：手动下载 .deb 包，适合需要固定版本或离线安装的场景。
  • 关键提示：若使用需要 Sass/SCSS 的主题，必须确保安装的是扩展版（含 extended 标识）。

在 Ubuntu 系统中，若通过 snap 安装了 Hugo，但无法通过 hugo 命令调用，可能是 环境变量未正确加载、路径冲突 或 snap 服务异常 导致。以下是具体排查和解决步骤：

一、确认 snap 包已正确安装

首先验证 snap 中 Hugo 的安装状态：

snap list | grep hugo

输出应类似:

hugo   0.147.4+extended   100  latest/stable  hugoio      -

若状态为 active，说明安装成功；若状态异常（如 installing 卡住），需修复 snapd 服务（见下文步骤）:

二、检查 snap 应用路径是否在 PATH 中

snap 安装的应用默认存放在 /snap/bin 目录，该目录需包含在系统 PATH 环境变量中才能直接调用。

步骤 1：查看当前 PATH

echo $PATH

输出应包含 /snap/bin（示例）：

/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin

步骤 2：手动添加 /snap/bin 到 PATH（临时生效）

若 PATH 中无 /snap/bin，临时添加：

export PATH="/snap/bin:$PATH"

再次执行 hugo version，若能正常输出，说明是 PATH 问题。

步骤 3：永久添加 PATH（推荐）

将 /snap/bin 添加到用户环境变量：

echo 'export PATH="/snap/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc  # 立即生效

三、排查路径冲突（存在其他 hugo 二进制文件）

若 PATH 已正确配置，但 hugo 仍无法调用，可能系统中存在其他 hugo 二进制文件（如 apt 残留或手动安装的版本），导致命令被覆盖。

步骤 1：查看 hugo 命令的实际路径

which hugo
  • 若输出 /usr/bin/hugo 或 /usr/local/bin/hugo，说明存在其他版本的 Hugo 残留（即使已通过 apt 卸载）。
  • 若输出 /snap/bin/hugo，则路径正确（见下文其他原因）。

步骤 2：彻底清理残留的 Hugo 二进制文件

# 检查所有 Hugo 相关文件
sudo find / -name "hugo" 2>/dev/null

# 手动删除非 snap 路径的 Hugo 二进制文件（示例）
sudo rm /usr/bin/hugo
sudo rm /usr/local/bin/hugo

四、检查 snapd 服务状态

snapd 服务异常可能导致已安装的 snap 包无法被系统识别。

步骤 1：重启 snapd 服务

sudo systemctl restart snapd

步骤 2：验证服务状态

sudo systemctl status snapd

输出应显示 active (running)，若状态为 failed，需修复服务：

sudo systemctl enable snapd  # 启用服务
sudo systemctl start snapd   # 启动服务

五、重新安装 snap 的 Hugo（终极方案）

若以上步骤无效，尝试重新安装 snap 的 Hugo：

# 卸载当前 snap 包（保留配置）
sudo snap remove hugo

# 重新安装扩展版（确保路径正确）
sudo snap install hugo --channel=extended/stable

六、验证最终效果

hugo version

应输出类似以下内容（含 extended 标识）：

hugo v0.147.4+extended linux/amd64 BuildDate=2024-05-15T12:34:56Z