C++标准库不支持PSD解析，libpsd是轻量、开源、纯C且持续维护的首选方案；它完整保留图层、混合模式与蒙版信息，而stb_image等仅解码像素；需手动处理UTF-16BE图层名、递归解析嵌套结构，并注意大文件内存管理及RLE蒙版兼容性。
PSD解析没有标准C++库，得靠第三方或自己啃格式
直接说结论：C++标准库完全不支持PSD解析，libpsd 是目前最轻量、开源且仍在维护的纯C实现（可直接C++调用），比OpenCV、Magick++等通用图像库更专注图层结构。别指望用stb_image或FreeImage读PSD图层——它们只解码像素，丢弃所有图层、混合模式、蒙版信息。
libpsd编译和基础图层遍历怎么做
从GitHub拉取 libpsd（注意选最新 release，不是 master 分支，后者有未修复的内存越界）；它不依赖 CMake，直接把 src/ 下所有 .c 和 .h 加进你的项目即可。关键函数是 psd_load_file()，返回 psd_context * 指针：
psd_context *ctx = psd_load_file("test.psd");
if (!ctx || ctx->error != psd_status_done) {
// 错误码在 ctx->error，常见如 psd_status_invalid_signature
return;
}
// 图层数量存在 ctx->layer_count，每层是 ctx->layers[i]
for (int i = 0; i < ctx->layer_count; i++) {
psd_layer_record *layer = &ctx->layers[i];
printf("Name: %s, Blend Mode: %d, Opacity: %d\n",
layer->name, layer->blend_mode, layer->opacity);
}
注意：layer->name 是 UTF-16BE 编码的原始字节，需手动转 UTF-8；layer->blend_mode 是整数枚举，对应 PSD 规范里的 norm（正常）、mul （正片叠底）等字符串标识，查 psd_blend_mode_name() 函数可转。
读不到隐藏图层或调整图层？检查图层组和标志位
libpsd 默认只暴露顶层图层（ctx->layers），嵌套组、调整图层、矢量蒙版全藏在 layer->layer_info 的链表里。关键字段是 layer->visible（是否可见）、layer->clipping（是否为剪贴蒙版底层）、layer->layer_type（0=普通像素层，3=调整图层，7=图层组）。
立即学习“C++免费学习笔记（深入）”；
- 调整图层（如曲线、色阶）的参数存在
layer->layer_info的psd_layer_info_color_balance等结构中，需按layer->layer_info_type类型强制转换指针 - 图层组本身不带像素，但
layer->layer_count表示其子层数，子层数据紧随该组之后存于ctx->layers数组中——需递归解析 - 隐藏图层仍被加载，只是
layer->visible == 0，别用continue跳过，否则会错乱后续索引
中文图层名乱码、大文件崩溃？必须处理编码和内存
PSD 的图层名用 UTF-16BE 存储，且可能含 BOM；libpsd 不做转码。直接 printf("%s", layer->name) 必然乱码。推荐用 iconv 或手写简单转换（先跳过前2字节BOM，再逐对字节反转）。
大文件（>500MB）容易触发 psd_load_file() 内存分配失败，因为 libpsd 把整个 PSD 文件 mmap 到内存。生产环境务必用 psd_load_from_memory() + 自定义缓冲区分块读取，避免单次 malloc 过大。
真正麻烦的是图层蒙版数据——它可能以压缩（Zip）或原始方式存储，libpsd 只解压 Zip 格式蒙版，若遇到 RLE 压缩（Photoshop 旧版本常用），会返回空数据。此时只能换用 psdparse（Rust）或 Python 的 psd-tools 做预处理导出 JSON 再喂给 C++。
