Windows 系统安装 Hugo 完全指南：从零开始搭建你的第一个静态网站

前言

Hugo 是目前最流行的静态网站生成器之一，由 Go 语言编写，以极快的构建速度和灵活的模板系统著称。无论你是想搭建个人博客、公司官网，还是技术文档站点，Hugo 都是一个绝佳的选择。本教程将手把手教你在 Windows 系统上安装 Hugo，并创建并运行你的第一个网站。无需任何编程基础，跟着步骤走就能完成。

一、什么是 Hugo？

在开始安装之前，我们先简单了解一下 Hugo：

静态网站生成器: 将 Markdown 内容 + 主题模板 → 生成纯 HTML/CSS/JS 文件
速度极快： 一个中型网站（几百篇文章）可以在几秒内完成构建
无需数据库： 所有内容都是文件，部署简单丰富的主题生态：官方主题库有数百个免费主题

二、安装前的准备工作

系统要求

操作系统：Windows 7 及以上（推荐 Windows 10/11）
硬盘空间：至少 500MB 可用空间
网络连接：需要下载安装包
所需工具
浏览器（用于下载文件）
命令行工具（CMD 或 PowerShell）

三、安装方法（二选一）

我推荐两种安装方式，你可以根据自己的喜好选择。

方法一：使用 Scoop 包管理器（推荐）

Scoop 是 Windows 上的包管理器，就像 Linux 的 apt 或 macOS 的 Homebrew。使用它安装 Hugo 非常方便，而且更新也简单。

步骤 1：安装 Scoop

右键点击"开始"按钮，选择 Windows PowerShell (管理员)
在弹出的窗口中，运行以下命令：

1
2


Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

等待安装完成，你会看到 Scoop 的版本信息

步骤 2：使用 Scoop 安装 Hugo

在同一个 PowerShell 窗口中输入：

1

scoop install hugo

注意： 如果要安装扩展版（支持 Sass/SCSS），请使用：

1

scoop install hugo-extended

等待下载和安装完成，Scoop 会自动配置环境变量

后续更新 Hugo

1

scoop update hugo

方法二：手动下载安装（适合所有用户）

如果你不想安装 Scoop，或者想控制 Hugo 的具体版本，可以使用手动安装方式。

步骤 1：下载 Hugo

打开浏览器，访问 Hugo 的 GitHub Releases 页面： https://github.com/gohugoio/hugo/releases
找到最新的稳定版，下载适合 Windows 的压缩包：

64位系统：hugo_extended_0.123.0_windows-amd64.zip（推荐扩展版）
或 hugo_0.123.0_windows-amd64.zip（标准版）

步骤 2：解压文件

下载完成后，找到 .zip 文件
右键点击，选择"解压到当前文件夹"
你会看到一个 hugo.exe 可执行文件

步骤 3：放置 Hugo 到合适位置

创建一个文件夹用于存放 Hugo，例如：

C:\hugo\bin\
或 D:\tools\hugo\

将 hugo.exe 移动到该文件夹中

步骤 4：配置环境变量（关键步骤）

为了让系统在任何位置都能识别 hugo 命令，需要配置环境变量：

在 Windows 搜索框输入"环境变量"，点击"编辑系统环境变量"
在弹出的窗口中，点击右下角的"环境变量"按钮
在"系统变量"列表中找到 Path，双击打开
点击"新建"，然后输入你放置 hugo.exe 的完整路径（例如 C:\hugo\bin）
点击"确定"关闭所有窗口

四、验证安装是否成功

无论使用哪种方法，安装完成后，都需要验证：

关闭并重新打开 CMD 或 PowerShell 输入以下命令并按回车：

1

hugo version

如果看到类似以下输出，说明安装成功： hugo v0.123.0+extended windows/amd64 BuildDate=2024-03-01T12:00:00Z

如果提示"hugo 不是内部或外部命令"，说明环境变量配置失败，请检查 Path 设置

五、创建你的第一个 Hugo 网站

安装成功只是第一步，接下来我们创建一个真实的网站来测试。

步骤 1：创建新站点

打开 CMD 或 PowerShell，切换到你想存放项目的目录，例如桌面：

1

cd Desktop

运行以下命令创建新站点（myblog 是项目名，可以自定义）：

1

hugo new site myblog

你会看到成功提示： Congratulations! Your new Hugo site is created in C:\Users\YourName\Desktop\myblog.

步骤 2：添加主题

Hugo 站点默认没有内容，需要先安装一个主题。

1

cd myblog

初始化 Git 仓库（用于下载主题）：

1

git init

下载一个简单主题（Ananke）：

1

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

4.将主题添加到配置文件中：

1

echo "theme = 'ananke'" >> config.toml

步骤 3：创建一篇文章

1.运行以下命令创建新文章：

1

hugo new posts/my-first-post.md

用记事本打开 content/posts/my-first-post.md 文件
将 draft: true 改为 draft: false
在 — 后面添加一些内容，例如：

1
2


# 我的第一篇文章
你好，世界！这是我的第一篇 Hugo 博客文章。

步骤 4：启动本地服务器

1

hugo server

2.你会看到类似输出： Web Server is available at http://localhost:1313/Press Ctrl+C to stop

步骤 5：查看你的网站

打开浏览器，输入地址：http://localhost:1313/
恭喜你！你应该能看到一个带有 Hugo 和 Ananke 主题的网站

六、常见问题与解决方法

问题 1：hugo 命令找不到

原因：环境变量未正确配置

解决：

检查 hugo.exe 所在路径是否已添加到系统 Path 变量
重启命令行窗口后重试

问题 2：浏览器显示空白页面

原因：

没有添加主题
文章是草稿状态（draft: true）

解决：

确认 config.toml 中有 theme = ‘ananke’
确认文章头部 draft: false

问题 3：编译错误 - Sass/SCSS 相关

原因：安装了标准版 Hugo，但主题需要扩展版

解决：

卸载标准版，安装 hugo_extended 版本
使用 Scoop 安装：scoop install hugo-extended

问题 4：端口被占用

原因：其他程序占用了 1313 端口

解决：

使用其他端口：hugo server -p 1314

问题 5：配置文件警告

原因：使用了过时的配置项

解决：

将 languageCode 改为 locale
将 languageName 改为 label

七、后续学习资源

安装成功只是开始，下面是一些推荐的学习路径：

学习 Hugo 目录结构： 了解 content、layouts、themes 等文件夹的作用
学习 Markdown 语法： Hugo 的内容使用 Markdown 编写
探索 Hugo 模板系统： 学习如何自定义网站的布局和样式
**部署你的网站：**将 Hugo 生成的静态文件部署到 GitHub Pages、Netlify、Vercel 等平台

八、总结

通过本教程，你已经成功完成了：

✅ 安装 Hugo（Scoop 或手动方式）
✅ 验证安装成功
✅ 创建第一个 Hugo 网站
✅ 添加主题并创建文章
✅ 启动本地服务器现在，你已经掌握了 Hugo 在 Windows 系统上的安装和基本使用方法。接下来，可以开始深入学习 Hugo 的更多高级功能，打造属于你自己的网站！
祝你学习愉快，期待看到你的 Hugo 作品！ 🚀