3. 缓存机制原理：Kustomize本地缓存目录结构、缓存键生成规则、缓存命中与未命中流程

Kustomize 在执行 kustomize build 时，会从远程 Git 仓库或 OCI 镜像仓库拉取 base 与 overlay 依赖。为了加速重复构建、减少网络开销，Kustomize 在本地维护了一套基于内容寻址的缓存系统。理解其目录结构、键生成规则以及命中/未命中流程，是进行缓存命中性能测试的理论基础。

3.1 本地缓存目录结构

Kustomize 的缓存默认存储在 $HOME/.kustomize/cache 目录下。其结构按仓库类型（Git / OCI）和引用标识分层组织，形成两级目录树：

3.2 缓存键生成规则

缓存键（Cache Key）是决定缓存是否命中的核心标识。Kustomize 采用 内容寻址 策略，键值由以下三个要素通过 SHA-256 哈希生成：

1. 仓库引用（Repository Reference）：完整的 Git 远程 URL 或 OCI 镜像地址，包括协议、主机、路径。
2. 版本标识（Version Ref）：分支名、Tag 或 Commit SHA。注意：分支名会被解析为当前指向的 Commit SHA 后再参与哈希计算，避免分支漂移导致缓存污染。
3. 子路径（Subpath）：如果 kustomization.yaml 位于仓库子目录（如 deploy/overlays/prod），该相对路径也会参与哈希。

3.3 缓存命中与未命中流程

Kustomize 在构建时按以下流程判断缓存状态，该流程直接影响构建延迟和网络 I/O：

3.4 命中与未命中的性能差异

缓存命中与否对构建延迟的影响呈数量级差异。以下是在典型 CI/CD 环境（网络延迟 50ms，带宽 100Mbps）下的实测对比：

3.5 缓存失效场景

以下操作会导致缓存键变化，从而触发缓存未命中：

• Commit SHA 变更：分支指向新提交，重新解析后哈希不同。
• 子路径修改：kustomization.yaml 在仓库内的相对路径发生变化。
• 仓库 URL 变更：切换镜像源或 Git 远程地址。
• 缓存目录被清理：CI 节点重建、磁盘空间回收或手动 rm -rf。
• Kustomize 版本升级：不同版本的缓存序列化格式可能不兼容（罕见但需注意）。