Hugo 命令使用完全指南

Fri, 19 Jun 2026 22:33:20 +0800

Hugo 命令使用指南

Hugo 是基于 Go 语言开发的静态站点生成器，所有核心能力都可以通过命令行完成调用。本指南按使用场景分类，覆盖从项目初始化、本地开发、内容管理到生产构建的全流程命令，并附带参数说明、使用示例和最佳实践。

查看 Hugo 所有命令的总览，也可以在任意子命令后加 --help 查看该命令的详细参数。

# 查看所有命令总览
hugo help

# 查看 server 子命令的详细参数
hugo server --help
# 简写
hugo server -h

查看当前安装的 Hugo 版本、操作系统架构、Go 版本信息，常用于排查兼容性问题。

hugo version
# 输出示例：hugo v0.128.0+extended linux/amd64 BuildDate=...

注意：带 extended 标识为扩展版，支持 Sass/SCSS 编译；多数主题需要扩展版才能正常构建。

打印完整的 Hugo 运行环境信息，包括版本、配置路径、环境变量、模块缓存路径等，排查构建问题时常用。

hugo env

创建一个全新的 Hugo 站点项目，生成标准的目录结构。