partials.IncludeCached

partials.IncludeCached 布局 上下文 [变体...]

any

partialCached

partialCached 模板函数可显著提高复杂模板的性能，因为这些模板不需要每次调用时重新渲染。

**注意：**每个站点（或语言）都有自己的 partialCached 缓存，因此每个站点只执行一次部分。

**注意：**Hugo会并行渲染页面，并通过并发调用 partialCached 函数多次渲染部分。在 Hugo 缓存渲染部分之后，进入构建流程的新页面将使用缓存结果。

以下是最简单的用法：

{{ partialCached "footer.html" . }}

您还可以向 partialCached 传递其他参数以创建变体缓存部分。例如，如果您有一个复杂的部分，当为同一部分中的页面渲染时应该是相同的，您可以使用基于部分的变体，以便每个部分仅渲染一次：

{{ partialCached "footer.html" . .Section }}

如果需要传递其他参数以创建唯一的变体，可以根据需要传递任意多个变体参数：

{{ partialCached "footer.html" . .Params.country .Params.province }}

请注意，变体参数不会传递给底层部分模板。它们仅用于创建唯一的缓存键。自 Hugo 0.61.0 起，您可以使用任何对象作为缓存键，而不仅仅是字符串。

另请参阅完整部分系列第1部分：缓存！。