VSCode 本身不提供 Helm 模板语法补全或预览能力，必须靠插件组合 + 正确配置才能生效。单独装一个插件、只改一两行设置，90% 的人会卡在「没提示」「点不动」「补全错乱」上。
为什么 helm template 能跑通但 VSCode 里 {{ .Values.xxx }} 就没补全？
因为 Helm 运行时解析 values.yaml 是动态的，而 VSCode 插件需要静态可分析的结构。插件不会执行 helm template，它只读取当前 Chart 目录下的 values.yaml（含嵌套）和所有 *.tpl 文件，构建本地符号表。
- 如果你的
values.yaml里用了{{ include "some.template" . }}动态引用，插件无法展开——它只认字面量定义 - 如果
values.yaml在子目录（如environments/prod/values.yaml），默认不识别，必须用helm-Intellisense.valuesPaths手动指定路径 - 插件只扫描
templates/下的.yaml和.tpl文件，charts/子 chart 的 values 不计入主 chart 补全范围
helm-Intellisense 插件安装后仍无补全？检查这三处
不是装完就自动工作。它依赖 VSCode 对当前文件的“上下文感知”是否到位：
- 确保你打开的是 Helm Chart 根目录（含
Chart.yaml），而不是某个单独的deployment.yaml文件——插件靠Chart.yaml定位项目边界 - 确认文件语言模式是 YAML（不是 YAML (Kubernetes) 或 Plain Text）：右下角点击 →
Change Language Mode→ 输入yaml回车；Helm 模板文件不需要切到 Kubernetes 模式 - 检查插件设置里
"helm-Intellisense.enabled": true是否开启，且未被 workspace 设置覆盖；某些团队禁用了全局插件，需在项目根目录建.vscode/settings.json显式启用
如何让 {{ include "common.labels" . }} 也能被识别和补全？
命名模板（Named Templates）的补全依赖插件扫描所有 *.tpl 文件并提取 {{ define "xxx" }} 块。但它有硬性限制：
- 模板名必须是字符串字面量，不支持变量拼接：
{{ include (print "common." $type) . }}→ 插件完全忽略 - 定义必须在
templates/_*.tpl或templates/*.tpl中，放在templates/deployment.yaml里的{{ define }}不会被索引 - 跨文件引用要小心：若
_helpers.tpl里定义了common.labels，而你在ingress.yaml里写{{ include "common.labels" . }}，补全能触发；但如果_helpers.tpl被误删或重命名，插件不会报错，只会静默失效
预览渲染结果：别信 helm template CLI 输出，用 VSCode 内置方式验证
插件不提供实时预览面板，但你可以用 VSCode 自带功能低成本验证模板逻辑是否正确：
- 在模板文件任意位置右键 →
Helm: Preview Template（需插件支持）→ 生成当前文件的渲染快照，显示哪些.Values字段缺失、哪些include找不到定义 - 更可靠的做法：在终端运行
helm template . --debug --dry-run，把输出重定向到临时文件，再用 VSCode 打开对比；注意加--debug才能看到实际渲染出的 YAML，否则只显示 release 名称 - 警惕
if条件块：插件无法判断{{ if .Values.ingress.enabled }}是否为真，所以ingress.yaml里所有条件分支内的字段都不会出现在补全建议中——你得自己记住结构
最易被忽略的一点：插件对 values.schema.json 完全无感。哪怕你写了严格的 JSON Schema 约束 .Values.service.port 必须是整数，VSCode 也不会在补全时过滤掉字符串类型的键。补全只反映「存在」，不校验「合法」。
