Hugo 简介：为何选择 Hugo，以及您的第一个 Hugo 网站

Apr 23, 2026 in 技术
hugo 静态网站博客 markdown
2 min read

Hugo 是一个用 Go 语言编写的静态网站生成器。它以其极高的构建速度、灵活的配置选项以及强大的功能集而闻名，迅速成为开发者构建博客、文档网站、作品集等静态内容的流行选择。如果您正在寻找一种高效、简单且可扩展的方式来创建和管理您的网站，Hugo 绝对是值得您考虑的。

为什么选择 Hugo？

惊人的速度: Hugo 以其闪电般的构建速度著称。即使是拥有成千上万个页面和大量内容的网站，Hugo 也能在几秒钟内完成构建，这极大地提升了开发和部署的效率。
易于安装与使用: Hugo 是一个单一的可执行文件，无需复杂的安装过程。下载并解压即可使用。其命令行接口 (CLI) 直观易懂，上手非常快。
灵活的内容管理: Hugo 支持 Markdown 格式来撰写内容，这是目前最流行的轻量级标记语言。同时，它还提供了强大的内容组织能力，支持分类、标签、自定义内容类型等，可以满足各种复杂的网站需求。
丰富的自定义主题: Hugo 拥有一个庞大的社区，贡献了海量的免费和付费主题。您可以轻松找到符合您设计风格的主题，快速搭建起一个美观的网站，而无需从零开始编写 HTML/CSS。
强大的模板系统: Hugo 使用 Go 的 html/template 库作为其模板引擎，提供了非常灵活的模板自定义能力。您可以轻松地修改现有主题，或从头开始创建自己的主题。
内置开发服务器: Hugo 提供了一个内置的开发服务器，支持“实时重载”。当您修改内容或模板时，网站会在浏览器中自动刷新，让您实时预览更改效果，极大地提高了开发体验。
无需数据库，部署简单: 作为静态网站生成器，Hugo 的输出是纯粹的 HTML、CSS 和 JavaScript 文件。这意味着您不需要数据库，部署也非常简单，可以直接托管在任何静态文件服务器上，如 GitHub Pages, Netlify, Vercel, AWS S3 等。
SEO 友好: 静态网站通常具有更好的加载速度和更简洁的 HTML 结构，这都有助于搜索引擎优化 (SEO)。Hugo 的主题也普遍注重 SEO 实践。

安装 Hugo

Hugo 的安装非常简单，通常只需要下载对应的二进制文件即可。

访问 Hugo 官网: 前往 https://gohugo.io/getting-started/installing/ 页面。
选择适合您操作系统的安装方式: 官网提供了多种安装方法，包括直接下载二进制文件、使用包管理器（如 Homebrew, Chocolatey）或从源码编译。
- macOS (使用 Homebrew):
```
brew install hugo
```
- Windows (使用 Chocolatey):
```
choco install hugo-extended
```
  （推荐安装 hugo-extended 版本，它包含了 Sass/SCSS 的支持。）
- Linux (使用 Snap):
```
sudo snap install hugo --channel extended
```
验证安装: 打开您的终端或命令提示符，运行：
```
hugo version
```
如果安装成功，您将看到 Hugo 的版本信息。

创建您的第一个 Hugo 网站

现在，让我们来创建一个简单的 Hugo 网站。

创建新的 Hugo 网站: 在您想要创建网站的目录下，打开终端，然后运行以下命令：
```
hugo new site my-first-hugo-site
```
这会在当前目录下创建一个名为 my-first-hugo-site 的新文件夹，并包含 Hugo 网站所需的基本目录结构（如 archetypes/, content/, data/, layouts/, static/, themes/, config.toml）。
进入网站目录:
```
cd my-first-hugo-site
```
选择并添加一个主题: Hugo 的核心在于主题。您可以从 themes.gohugo.io 上选择一个喜欢的主题。这里我们以一个简单的博客主题为例（例如 ananke，您可以替换成您喜欢的其他主题）。
- 使用 Git Submodule (推荐): 在一个新的终端窗口中，进入您的网站目录，然后执行：
```
git init # 如果您的网站目录还没有初始化 Git
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
```
- 手动下载: 您也可以直接从 GitHub 下载主题的 ZIP 文件，然后解压到 themes/ 目录下，并重命名为主题的名称（例如 ananke）。

配置网站使用主题: 编辑您网站根目录下的 config.toml 文件（如果不存在，请创建它），并添加以下内容：

baseURL = "http://example.org/" # 替换为您的网站部署后的 URL
languageCode = "zh-cn"
title = "我的第一个 Hugo 网站"
theme = "ananke" # 确保这里的名称与您添加到 themes/ 目录下的主题文件夹名称一致

创建您的第一篇博客文章: 在终端中，运行以下命令来创建一个新的 Markdown 文件：

hugo new posts/my-first-post.md

这会在 content/posts/ 目录下创建一个名为 my-first-post.md 的文件。打开这个文件，您会看到类似以下的 front matter（元数据）：

---
title: "My First Post"
date: 2026-04-23T10:00:00+08:00
draft: true # 默认是草稿状态
---

将 draft: true 修改为 draft: false，并添加一些内容：

---
title: "我的第一篇博客文章"
date: 2026-04-23T10:00:00+08:00
draft: false
---

你好，Hugo！

这是我的第一篇使用 Hugo 博客的文章。我正在学习如何使用 Markdown 来写作，并且对 Hugo 的速度和易用性感到非常惊喜。

Hugo 的主题系统非常强大，我选择了一个非常简洁的主题来开始。

运行 Hugo 开发服务器: 在网站根目录下，运行：
```
hugo server
```
Hugo 会启动一个本地开发服务器，并在终端中显示访问地址，通常是 http://localhost:1313/。打开您的浏览器，访问该地址，您应该能看到您刚刚创建的网站，以及您的第一篇博客文章。

总结

Hugo 是一个强大且高效的静态网站生成器，非常适合个人博客、项目文档、作品集等场景。通过简单的安装、主题选择和 Markdown 写作，您就能快速搭建起一个功能完善的网站。立即开始您的 Hugo 之旅吧！