Values 对象与嵌套访问
深入树状结构读取用户配置
Values 对象与嵌套访问 是 CoddyKit 上的免费 Helm Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Helm Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Helm Academy 课程共包含 4 节课。
认识 Values 对象
在模板中，.Values 保存来自 chart 的 values.yaml 以及您传入的所有覆盖值。它就是您的配置树。
读取顶层键
像 replicaCount 这样的顶层键会变成 .Values.replicaCount。点号路径与 YAML 结构完全对应。🌳
# values.yaml
replicaCount: 3
# template
replicas: {{ .Values.replicaCount }}深入嵌套映射
值发生嵌套时，您需要连续使用点号。包含 tag 键的 image 映射可以通过 .Values.image.tag 访问，每一段对应一个层级。
# values.yaml
image:
repository: nginx
tag: "1.27"
# template
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}键区分大小写
路径中的每一段都必须与 YAML 键逐字符匹配。.Values.Image 与 .Values.image 不同，渲染结果会为空。
缺失的键会渲染为空
请求不存在的值默认不会产生错误。Helm 什么也不会渲染，这可能会悄悄生成无效的 YAML。
带短横线的键需要使用 index
点号语法无法处理带短横线的键。请使用 index 函数，并将键写成带引号的字符串来访问它们。
# values.yaml
service-port: 8080
# template
port: {{ index .Values "service-port" }}默认值从哪里来
chart 作者会在 values.yaml 中提供合理的默认值。除非用户覆盖某个键，否则其中的每个键都可以通过 .Values 访问。
覆盖值如何进入 .Values
用户的 --set 标志或 -f 文件会在渲染前合并到默认值之上。到了模板处理时，.Values 已经是最终合并后的树。
helm install web ./mychart --set replicaCount=5列表也位于 .Values 下
YAML 列表会在 .Values 下变成切片。您可以遍历它来渲染重复项目，而不是通过单一路径读取它。🔁
# values.yaml
ports:
- 80
- 443安全地为值加引号
数字和布尔值会以原始形式渲染，这可能破坏 YAML。请将用户输入的字符串包裹在 quote 函数中，使其保持为有效文本。
tag: {{ .Values.image.tag | quote }}使用前先检查这棵树
对 chart 运行 helm show values 可以打印完整的值树。该输出就是您通过 .Values 访问的确切结构。
helm show values ./mychart快速检查
您需要访问一个名为 service-port 且包含短横线的 values 键。
回顾：Values 树
您已经了解到，.Values 是合并后的配置树，通过点号路径访问，并且区分大小写；对于特殊键则使用 index。您可以使用 helm show values 检查它。
常见问题解答
「Values 对象与嵌套访问」课时是免费的吗？
是的 — 「Values 对象与嵌套访问」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Helm Academy 课程的其余内容，请升级到 CoddyKit PRO。 Helm Academy 课程共包含 4 节课。
「Values 对象与嵌套访问」这节课中我会学到什么？
深入树状结构读取用户配置 你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Helm Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Helm Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「Values 对象与嵌套访问」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Helm Academy 课中编写并运行代码吗？
能。每节 Helm Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。