vscode无helm渲染引擎，插件仅提供语法高亮、跳转和基础校验；values.yaml修改后需手动运行helm template预检，因变量引用和条件块仅在cli执行时展开计算。
VSCode 本身不渲染 Helm Chart，所谓“实时预览”只能靠手动触发 helm template 查看渲染结果；插件只负责编辑辅助，不替代 CLI。
为什么改了 values.yaml，预览里看不到效果？
因为 VSCode 没有内置 Helm 渲染引擎，Helm 插件（如 docsmsft.helm）既不运行 helm template，也不缓存或展示渲染后的 YAML。它只做三件事：语法高亮、字段跳转、基础 schema 校验（需配 schema.yaml）。你看到的 values.yaml 是纯文本，不是“已合并模板后的结果”。
- 所有变量引用（如
{{ .Values.replicaCount }}）在编辑器里只是字符串，不会被计算或展开 - 条件块（
{{- if .Values.ingress.enabled }}）是否生效，只有执行helm template才知道 - 插件报错 ≠ 渲染失败；比如
replicaCount: "2"在 YAML 合法，但模板里写{{ .Values.replicaCount + 1 }}就会 panic
怎么快速验证 values 修改是否真能通过渲染？
别等 helm install 失败再查，用 helm template 做轻量预检。这是最接近“实时预览”的实操方式：
- 在 Chart 根目录打开 VSCode 内置终端（Terminal → New Terminal）
- 确保当前上下文有可用
kubeconfig（kubectl config current-context能返回值） - 运行：
helm template myrelease ./mychart --debug --dry-run | head -30 - 加
--debug显示完整渲染过程，--dry-run避免误触发 hook，| head -30只看开头，快速判断卡在哪 - 如果报
error converting YAML to JSON，说明生成的 YAML 有语法问题；如果是nil pointer evaluating interface {}.xxx，就是 values 缺字段
如何让 VSCode 终端真正“认得” helm 和 kubectl？
常见现象：插件语法高亮正常，但终端里 helm version 报 command not found。这不是插件问题，是环境没继承到位：
- 确认 helm 已安装且在系统
PATH中（macOS/Linux 运行which helm，Windows 运行where helm） - VSCode 启动方式影响环境变量：直接从 Dock 或开始菜单启动，可能不加载 shell 的
~/.zshrc或~/.bashrc；推荐从终端执行code .启动 - Windows + Git Bash 用户：检查
~/.bashrc是否导出KUBECONFIG，且 VSCode 终端 Shell 设置为 Git Bash（设置中搜terminal.integrated.defaultProfile） - Mac M1/M2 用户：若 helm 安装在
/opt/homebrew/bin，确保该路径已加入PATH并被 VSCode 继承
能不能一键运行 helm template？可以，但得自己配任务
VSCode 不提供 Helm 专用按钮，但可通过 .vscode/tasks.json 实现快捷键触发：
{
"version": "2.0.0",
"tasks": [
{
"label": "helm: template dev",
"type": "shell",
"command": "helm template dev ./mychart --debug --dry-run",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
保存后，按 Ctrl+Shift+P → 输入 Tasks: Run Task → 选 helm: template dev，就能在集成终端里跑一次渲染。注意把 ./mychart 换成你实际 Chart 路径。
真正的难点不在配置，而在于理解：Helm 是声明式模板工具，它的“预览”本质是执行时行为。任何脱离 helm template 的所谓可视化预览，都是残缺的——哪怕插件标榜“智能”，也绕不开这个前提。
