yaml-cpp是解析kubeconfig文件最直接选择，支持YAML 1.2完整语法，能正确处理锚点、别名、嵌套结构及base64字段；需校验apiVersion=="v1"和kind=="Config"，手动解析context链式引用，并对client-certificate-data等base64字段解码。
用 yaml-cpp 解析 kubeconfig 文件最直接
Kubeconfig 是 YAML 格式，C++ 没有标准 YAML 库，必须依赖第三方。目前最成熟、被 Kubernetes 官方 client-go 以外生态广泛采用的是 yaml-cpp。它支持完整 YAML 1.2 语法，能正确处理 kubeconfig 中常见的锚点（&cluster）、别名（*cluster）、嵌套结构和 base64 字段（如 client-certificate-data）。
安装方式取决于你的构建系统：vcpkg install yaml-cpp 或 conan install yaml-cpp/0.8.0；若手动编译，注意启用 YAML_CPP_BUILD_CONTRIB 以支持流式解析（虽 kubeconfig 不需要，但避免后续扩展踩坑）。
关键点：kubeconfig 的顶层是 map，键固定为 apiVersion、kind、clusters、users、contexts、current-context —— 解析时应先校验 apiVersion == "v1" 和 kind == "Config"，否则直接报错，不继续深挖。
读取 client-certificate-data 和 token 时要 Base64 解码
很多人直接把 client-certificate-data 当作字符串用，结果 TLS 握手失败。它本质是 PEM 格式证书的 base64 编码（无换行、无空格），必须解码后写入临时文件或传给 OpenSSL API。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
yaml-cpp读出的是std::string类型的原始编码串，不是二进制数据 - 推荐用
openssl/base64.h或轻量级实现（如boost::beast::detail::base64::decode），避免自己手写 base64 解码器出错 -
token字段不用解码，但要注意它可能含空格或特殊字符，需原样传递给 HTTP Authorization 头（Bearer <token>） - 私钥字段
client-key-data同样需 base64 解码，且解码后内容应包含-----BEGIN RSA PRIVATE KEY-----等 PEM 头尾
切换 context 时别只改 current-context 字符串
修改 current-context 只是更新了默认上下文名称，真正发起请求时还需从 contexts 列表中查出对应项，再按 context.cluster 和 context.user 去 clusters 和 users 中二次查找 —— 这个链式引用必须手动做，yaml-cpp 不会自动解析。
常见错误：
- 硬编码索引（如
config["contexts"][0]）而不是按 name 查找，导致切换 context 后仍连错集群 - 忽略
context.namespace字段，导致 Pod 列表请求默认发到defaultnamespace，而非用户期望的命名空间 - 未验证
cluster和user名是否存在，程序崩溃而不是友好提示
建议封装一个 resolve_context(const std::string& name) 函数，内部做三层查找 + 存在性检查，返回结构体而非裸指针。
Windows 下读取默认 kubeconfig 路径要小心路径分隔符
Linux/macOS 默认路径是 $HOME/.kube/config，Windows 是 %USERPROFILE%\.kube\config。环境变量展开、反斜杠转义、Unicode 路径都可能出问题。
- 不要用
getenv("HOME")，Windows 下为空；改用getenv("USERPROFILE")或SHGetFolderPath（Windows API） - 路径拼接统一用
std::filesystem::path（C++17），它能自动处理/和\，并支持 wide string - 打开文件前先调用
std::filesystem::exists()，避免yaml-cpp报 “file not found” 之外的模糊错误 - 如果 kubeconfig 在 OneDrive 或 WSL 路径下，注意权限和符号链接问题 —— 这类情况
std::ifstream可能静默失败
实际项目里，最好允许用户通过命令行参数（--kubeconfig <path>）或环境变量（KUBECONFIG）覆盖默认路径，比硬编码鲁棒得多。
