将作用域传入命名模板
向局部模板传递正确的上下文对象
将作用域传入命名模板 是 CoddyKit 上的免费 Helm Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Helm Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Helm Academy 课程共包含 4 节课。
局部模板需要上下文
命名模板只能读取您传给它的内容。include 的第二个参数就是作用域，也就是局部模板内部能够看到的点号对象。
{{ include "mychart.labels" . }}点号就是作用域
末尾的点号表示当前上下文。传入根点号后，局部模板就能访问 .Values、.Release 和 .Chart。
忘记作用域会导致错误
如果调用局部模板时没有传入作用域，它的点号就会变成 nil。此时其中对 .Values 的任何引用都会渲染为空或产生错误。
{{ include "mychart.name" }}传入根上下文
大多数辅助模板都需要完整的 chart 上下文，因此您可以传入普通点号。这是最安全的默认方式，能让标准辅助模板正常工作。
{{ include "mychart.fullname" . }}传入子对象
有时局部模板只需要一部分值。您可以将一个子树传给它，使它的点号正好指向那部分内容。
{{ include "mychart.ports" .Values.service }}内部的点号会改变
当您传入 .Values.service 后，局部模板中的点号就变成了该对象。此时可以直接读取 .port，而不再需要读取 .Values.service.port。
{{- define "mychart.ports" -}}
port: {{ .port }}
{{- end -}}有意放弃根上下文
缩小作用域很方便，但也会让您无法访问 .Release 和全局值。局部模板只能看到您传入的对象。
使用 dict 同时传入两者
既需要子树又需要根上下文？请构建一个小型 dict 并传入，然后在局部模板中通过各自的键访问每一部分。
{{ include "mychart.tpl" (dict "top" . "svc" .Values.service) }}读取捆绑的作用域
在局部模板内部，按键解包 dict。现在您可以通过 .top 访问根上下文，通过 .svc 访问子树，两者能够同时使用。
{{- define "mychart.tpl" -}}
name: {{ .top.Release.Name }}
port: {{ .svc.port }}
{{- end -}}作用域错误很常见
最典型的问题是局部模板读取 .Release.Name，但调用它时传入的却是缩小后的作用域。请始终检查实际传入的上下文。
渲染以验证作用域
运行 helm template .，确认局部模板的输出已填充。字段为空通常意味着局部模板接收到的作用域不正确。
helm template my-release .快速检查
某个局部模板同时需要子树和 .Release.Name。您应该如何同时提供这两者？
回顾：传递作用域
局部模板名称后面的参数会设置它的点号。您可以传入根点号、子树，或使用 dict 将两者组合起来。作用域错误会导致输出为空。🎯
常见问题解答
「将作用域传入命名模板」课时是免费的吗？
是的 — 「将作用域传入命名模板」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Helm Academy 课程的其余内容，请升级到 CoddyKit PRO。 Helm Academy 课程共包含 4 节课。
「将作用域传入命名模板」这节课中我会学到什么？
向局部模板传递正确的上下文对象 你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Helm Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Helm Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「将作用域传入命名模板」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Helm Academy 课中编写并运行代码吗？
能。每节 Helm Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。