常见问题解答

Hugo 的论坛是一个活跃的用户和开发者社区，他们回答问题，分享知识，并提供示例。在超过20,000个主题中快速搜索往往可以找到你的问题的答案。在提出你的第一个问题之前，请确保阅读了如何提问的相关信息。

以下仅仅是新用户最常提的几个问题。

提示的错误消息表示某项功能不可用。原因是什么？

Hugo 提供了两个版本：标准版和扩展版。借助扩展版，你可以 (a) 在处理图片时编码为 WebP 格式，及 (b) 使用内置的 LibSass 编译器将 Sass 转换为 CSS。使用 Dart Sass 编译器并不需要扩展版。

当你试图使用上述任何一种操作时，如果你正在使用的是 Hugo 的标准版，Hugo 会报出以下错误：

错误: 在你当前的 Hugo 版本中，此功能不可用

为了解决这个问题，卸载标准版，然后安装扩展版。详情请参见安装一节。

为什么当我访问主页时看到"找不到页面"？

在 content/_index.md 文件中：

• draft 是否被设为 true？
• date 是否设置为未来的日期？
• publishDate 是否设置为未来的日期？
• expiryDate 是否设置为过去的日期？

如果以上问题的答案有任何一个是肯定的，那么你可以改变字段的值，或者使用以下的命令行选项：--buildDrafts，--buildFuture，或 --buildExpired。

为什么特定的部分没有被发布？

在 content/section/_index.md 文件中：

• draft 是否被设为 true？
• date 是否设置为未来的日期？
• publishDate 是否设置为未来的日期？
• expiryDate 是否设置为过去的日期？

如果以上问题的答案有任何一个是肯定的，那么你可以改变字段的值，或者使用以下的命令行选项：--buildDrafts，--buildFuture，或 --buildExpired。

为什么特定的页面没有被发布？

在 content/section/page.md 文件中，或者在 content/section/page/index.md 文件中：

• draft 是否被设为 true？
• date 是否设置为未来的日期？
• publishDate 是否设置为未来的日期？
• expiryDate 是否设置为过去的日期？

如果以上问题的答案有任何一个是肯定的，那么你可以改变字段的值，或者使用以下的命令行选项：--buildDrafts，--buildFuture， 或 --buildExpired。

为什么我看不到页面的任何子页面？

你可能有一个 index.md 文件，而不是 _index.md 文件。详情请参见[详情] (/content-management/page-bundles/).

index.md 文件和 _index.md 文件有什么区别？

一个带有 index.md 文件的目录是一个叶子包。带有 _index.md 文件的目录是一个分支包。详情请参见[详情] (/content-management/page-bundles/)。

为什么我的部分模板没有按预期渲染？

你可能在调用部分模板时忘记传递需求的上下文。例如：

{{/* 不正确 */}}
{{ partial "_internal/pagination.html" }}

{{/* 正确 */}}
{{ partial "_internal/pagination.html" . }}

在模板中，为变量赋值时 := 和 = 有什么区别？

使用 := 初始化一个变量，使用 = 为已经初始化过的变量赋值。详情请参见[详情] (https://pkg.go.dev/text/template#hdr-Variables).

当我给列表页面进行分页时，为什么页面集合没有按照规定被筛选？

你可能在同一页面多次调用 Paginate 或 Paginator 方法。详情请参见[详情] (/templates/pagination/#list-paginator-pages).

为什么有两种方式来调用一个短代码(shortcodes)？

如果短代码模板，或者起止短码标签之间的内容包含 markdown，则使用 {{% 短代码 %}} 格式。否则使用 {{< 短码 >}}格式。请参见[详情] (/content-management/shortcodes/).

我能使用环境变量来控制配置吗？

可以。请参见[详情] (/getting-started/configuration/#configure-with-environment-variables).

为什么我从一次构建到下一次看到的输出结果不一致？

最常见的原因是页面冲突（发布两个页面到同一路径）和并发影响。使用--printPathWarnings命令行选项检查页面冲突，并且在 论坛 发帖如果你怀疑有并发问题。

哪些页面方法触发内容渲染？

以下 Page 对象的方法能触发内容渲染：Content，FuzzyWordCount， Len， Plain， PlainWords，ReadingTime，Summary，Truncated， 和 WordCount。