hugo build

hugo build 子命令：显式构建整个项目。

hugo build 是父命令 hugo 的子命令，用来构建项目。它是主命令的显式写法：不写子命令时直接执行 hugo 同样会构建项目，两者行为一致，区别只在于书写方式。在脚本或文档中需要明确表达「构建」这一动作时，写成 hugo build 更清楚。

用法

hugo build [flags]

下表列出常用选项，完整列表请以 hugo build --help 的输出为准。

选项	说明
`-b, --baseURL`	站点根的主机名与路径
`-D, --buildDrafts`	构建时包含草稿内容
`-E, --buildExpired`	构建时包含已过期内容
`-F, --buildFuture`	构建时包含发布日期在未来的内容
`--cleanDestinationDir`	删除目标目录中的陈旧文件
`--config`	配置文件，默认使用项目中的 hugo.yaml、hugo.json 或 hugo.toml
`--configDir`	配置目录，默认为 config
`-c, --contentDir`	内容目录的文件系统路径
`-d, --destination`	写入输出文件的文件系统路径
`--disableKinds`	禁用某几类页面，例如首页、RSS
`--enableGitInfo`	为页面写入 Git 版本、日期与作者信息
`-e, --environment`	构建环境
`--gc`	构建后清理未使用的缓存文件
`-h, --help`	显示 build 的帮助信息
`--ignoreCache`	忽略已配置的文件缓存
`-l, --layoutDir`	布局目录的文件系统路径
`--logLevel`	日志级别，取值为 debug、info、warn、error
`--minify`	压缩受支持的输出格式
`--noBuildLock`	不创建 .hugo_build.lock 文件
`--quiet`	以安静模式构建
`-s, --source`	读取文件所相对的源路径
`--templateMetrics`	显示模板执行的统计信息
`-t, --theme`	要使用的主题，主题位于 themes/THEMENAME/ 下
`-w, --watch`	监听文件系统变化并按需重建

构建整个项目：

hugo build

做一次带草稿的本地构建：

hugo build --buildDrafts

输出到自定义目录并压缩：

hugo build --destination dist --minify