helm package仅校验Chart.yaml结构、递归压缩目录并打包依赖，不渲染模板、不检查语法、不验证镜像；它打包的是手动组织的YAML模板目录，与Go编译无关。
Go 项目本身不打包 Helm Chart，helm package 打的只是你手动组织好的 YAML 模板目录，和 Go 编译过程完全无关；真正要做的，是让 Chart 能正确部署你编译出的镜像——这靠的是 values.yaml 和 templates/ 里的占位符配合，不是靠 Go 代码生成 Chart。
helm package 命令到底在做什么
helm package 只做三件事：校验 Chart.yaml 结构（比如 apiVersion: v2）、递归压缩整个目录、把依赖子 Chart（charts/ 下）一起打进去。它不渲染模板，不检查 deployment.yaml 语法，也不验证镜像是否存在。
常见错误现象：helm package 成功，但 helm install 报 parse error in "mychart/templates/deployment.yaml": function "required" not defined——这是因为模板里用了 Helm 函数，但 package 阶段根本不执行解析。
- 必须确保
Chart.yaml中apiVersion是v2（Helm 3 默认，v1已废弃） - 如果有依赖，先运行
helm dependency update mychart/，否则charts/目录为空，package会静默忽略 - 输出路径用
--destination /tmp/charts显式指定，目标目录必须已存在，不能自动创建 - 不要手动修改
charts/下的.tgz文件——helm package会重新压缩整个charts/目录，覆盖你的改动
Go 应用的镜像怎么进 Chart
Go 二进制本身不进 Chart，进的是你构建并推送到 registry 的容器镜像。Chart 里只存引用方式：{{ .Values.image.repository }}:{{ .Values.image.tag }}。
立即学习“go语言免费学习笔记（深入）”；
容易踩的坑：values.yaml 里写死 image: quay.io/myorg/myapp:v1.2.0，导致 Chart 失去复用性；CI 流水线一换镜像地址，就得改模板，而不是只改 --set image.tag=...。
- Go 构建镜像时务必加
CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o app .，否则进scratch或distroless/static会报no such file or directory -
values.yaml至少定义image.repository、image.tag、image.pullPolicy（推荐IfNotPresent，避免每次拉取） -
templates/deployment.yaml中的command或args必须和 Dockerfile 里最终二进制路径严格一致，比如args: ["/app/myserver", "--port=8080"] - 本地调试用
helm install --set image.tag=dev-abc123，比反复改values.yaml更快也更安全
CI 中怎么自动打包并推送 Chart
关键不是“Go 打包 Chart”，而是用标准 Helm CLI 完成发布链路：构建镜像 → 更新版本号 → 打包 → 推送。
典型失败点：脚本里直接 helm package ./mychart，却没切到 mychart/ 目录下执行，或没提前运行 helm dependency update，结果打出的包缺依赖，helm install 时报 could not find chart。
- 先构建并推送 Go 镜像：
docker build -t ghcr.io/me/myapp:v1.2.0 . && docker push ghcr.io/me/myapp:v1.2.0 - 用脚本更新
Chart.yaml中的version（Chart 版本）和appVersion（Go 应用版本），别手改 - 执行
helm package --destination /tmp/charts mychart/，得到/tmp/charts/mychart-0.1.0.tgz - 推送到 OCI 仓库：
helm push /tmp/charts/mychart-0.1.0.tgz oci://ghcr.io/helm（Helm 3.8+ 原生支持，无需 ChartMuseum）
为什么 helm install 后 Pod 一直 ImagePullBackOff
这不是 Chart 打包问题，而是镜像拉取环节断了。最常见原因是 values.yaml 没生效，模板里实际渲染出的还是默认测试镜像（比如 nginx）。
验证方法：运行 helm template mychart --debug | grep image:，看输出是不是你预期的镜像地址。如果还是 nginx:1.20，说明 --set 没传对，或 values.yaml 路径错了。
- 检查
helm install是否加了--values values-prod.yaml或--set image.repository=...，且参数名和values.yaml结构完全匹配 - 确认镜像 registry 地址可被集群节点访问（私有 Harbor 需配置
imagePullSecrets） - 如果用 OCI 仓库，确保
helm push成功后，helm install时用的是oci://协议地址，而非本地路径 -
helm list看 release 状态是PENDING_INSTALL还是FAILED，前者说明还没开始拉镜像，后者才真卡在ImagePullBackOff
真正难调的不是打包命令本身，而是 values.yaml 和模板之间的变量传递是否被覆盖、是否拼错层级、是否在 CI 中被缓存旧值——这些地方一旦出错，helm package 完全不报，直到 install 时 Pod 才挂掉。
