入门 on Hugo 中文文档

快速开始

Thu, 01 Oct 2026 00:00:00 +0800

本教程带你完成四件事：创建项目、添加内容、配置项目、发布项目。

开始之前，请先：

你还需要熟悉命令行的基本操作。

Thu, 01 Oct 2026 00:00:00 +0800

安装 Hugo 之后，先运行下面的命令确认安装成功：

hugo version

查看全部可用命令与参数：

hugo help

查看某个子命令的帮助，使用 --help 参数：

hugo server --help

切换到项目目录后执行：

hugo build

hugo build 会构建项目，把文件发布到 public 目录。要发布到其他目录，可以使用 --destination 参数，或在项目配置中设置 publishDir。

Thu, 01 Oct 2026 00:00:00 +0800

每个 Hugo 项目都是一个目录，其中的子目录分别参与内容、结构、行为与呈现。

创建新项目时，Hugo 会生成一份项目骨架。例如：

hugo new project my-project

会生成这样的目录结构：