C# 无法直接调用 Helm 模板引擎，只能生成 values.yaml 并通过 Process.Start 调用 helm template；需用 YamlDotNet 正确序列化布尔/空值，传绝对路径、指定 --name-template，并验证输出 YAML 结构。
用 Helm CLI 渲染前，C# 本身不参与模板渲染
Helm 的模板渲染（helm template）是 Go 实现的，C# 无法直接“调用 Helm 模板引擎”或“注入 values.yaml 内容到 Helm 的 Go runtime 中”。你真正能做的，是用 C# 生成、修改、写入 values.yaml 文件，再调用外部 helm 进程执行渲染。
常见错误现象：试图找 Helm.TemplateEngine NuGet 包，或在 C# 里调用类似 helm.Render(...) 的方法 —— 这类 API 不存在。
- 所有 Helm 模板逻辑（
{{ .Values.xxx }}、range、include）只在helm template或helm install运行时由 Helm CLI 解析 - C# 能控制的只有：生成
values.yaml内容、拼接命令行参数、调用Process.Start("helm", "...") - 不要尝试反序列化 Helm chart 的
_helpers.tpl或解析templates/*.yaml—— 没有稳定公开的 .NET 绑定
用 YamlDotNet 写入 values.yaml 时注意嵌套与类型
直接写字符串拼接 values.yaml 很容易出错，推荐用 YamlDotNet 库序列化对象。但 YAML 的松散类型规则和 Helm 对 bool/null/int 的敏感性，会让某些值被意外转成字符串。
使用场景：你想把 C# 对象 new HelmValues { Replicas = 3, Enabled = true, Labels = new Dictionary<string string> { ["env"] = "prod" } }</string> 写成合法 values.yaml。
-
bool字段必须序列化为true/false（不是"true"），否则 Helm 会当字符串处理，{{ if .Values.enabled }}判定为true（非空字符串） - 空集合（如
new List<string>()</string>）默认序列化成[]，没问题；但null会被忽略或变成~，而 Helm 把~当null，可能触发{{ default "foo" .Values.bar }}回退 - 用
SerializerSettings关闭自动类型推断：new SerializerSettings { EmitDefaults = true, IgnoreNullValues = false } - 示例片段：
var serializer = new Serializer(new SerializerSettings { EmitDefaults = true }); var yaml = serializer.Serialize(values); // values 是强类型对象
调用 helm template 时路径和上下文容易出错
从 C# 执行 helm template 不是简单拼个命令就行。Helm 需要正确识别 chart 路径、values 文件位置、命名空间上下文，否则报错像 failed to load chart: path not found 或渲染出空清单。
-
--name-template必须指定（Helm 3.8+ 强制），否则报release name is required；建议用随机 ID 或业务前缀，如--name-template "myapp-{{ Guid.NewGuid() }}" -
--values后跟的是文件路径，不是内容；确保路径是绝对路径（Path.GetFullPath("values.yaml")），尤其在 Docker 容器或不同工作目录下调用时 - chart 目录不能是相对路径如
"./charts/mychart"，除非 C# 进程当前目录就是 Helm chart 根目录；更稳妥的是传绝对路径：Path.Combine(Directory.GetCurrentDirectory(), "charts", "mychart") - 如果 chart 依赖子 chart（
Chart.yaml里有dependencies），得先helm dependency build，否则template会失败
输出清单后别直接信任 YAML 结构
即使 helm template 成功返回 YAML，C# 接收后仍需验证是否真生成了预期资源。Helm 不校验模板语法是否匹配集群版本（比如用了 apps/v1 但集群是 v1.15），也不保证 values.yaml 字段名和模板中引用完全一致。
- 检查 stdout 是否为空，或是否包含
Error:/failed（注意 Helm 错误有时走 stderr，有时混在 stdout） - 用
YamlDotNet反序列化输出的 YAML 成IList<idictionary object>></idictionary>，确认至少有一个kind: Deployment等关键资源 - 如果模板里用了
{{- if .Values.enabled -}}但 C# 写的values.yaml漏了enabled字段，默认是null→if块不展开 → 输出为空，但命令行不报错 - 多文档 YAML（
---分隔）需用Deserializer.LoadAllFromString()，不能只用Load<object>()</object>
最麻烦的地方不在 C# 怎么写，而在 Helm 模板本身是否健壮：一个没加 default 的 .Values.image.tag，配上 C# 里忘记赋值的字段，就只能靠日志肉眼翻 templates/deployment.yaml 了。
