ICO文件是带目录头的复合容器，必须先解析6字节文件头和多个16字节ICONDIRENTRY目录项，再按dwImageOffset定位图像数据，不可直接当位图读取。
ICO文件结构不是简单位图，必须按规范解析目录头
直接用 LoadImage 或 cv::imread 读 ICO 文件大概率失败——它不是单张图像，而是带目录头的复合容器。Windows ICO 格式要求先读 6 字节文件头，再读若干个 16 字节的目录项（ICONDIRENTRY），每个项描述一个图标变体（不同尺寸/色深）。跳过这步直接当 BMP 解析，会把目录头当成像素数据，结果全是乱码。
关键字段顺序固定：bWidth、bHeight、wBitCount、dwBytesInRes、dwImageOffset。注意：bWidth 和 bHeight 为 0 表示 256×256（Win7+ 支持），不能当作无效尺寸跳过。
- 用
fread或std::ifstream::read逐字节读取，避免std::getline或文本模式换行截断 - 目录项数量存在
wReserved字段（必须为 0）、wType（必须为 1）校验，不满足则不是合法 ICO - Linux 下无系统 API 支持，必须手撸解析；Windows 下
ExtractIconEx只能提取已加载图标，无法获取原始像素数据
RGBA 转换要处理 AND mask 和 XOR mask 的双层结构
ICO 中每个图像实际由两部分组成：XOR mask（含颜色）和 AND mask（单色遮罩，决定透明区域）。很多解析器只读 XOR 部分，导致背景残留黑块或白边。正确做法是先读 AND mask（每行字节数 = ((width + 31) / 32) * 4），再读 XOR mask（按 wBitCount 判断格式：32 位为 BGRA，24 位为 BGR，8 位需查调色板）。
- AND mask 是高位优先的位图，第 i 位为 0 表示该像素完全透明，1 表示保留 XOR mask 对应像素
- 32 位 ICO 的 XOR mask 已含 alpha 通道，但部分旧工具生成的 32 位 ICO 仍带 AND mask，需同时检查
- 调色板偏移量在 XOR mask 数据前 4 字节（仅 8 位及以下需要），漏读会导致颜色全错
尺寸优先级和缩放逻辑必须手动控制
ICO 文件常含多个尺寸（16×16、32×32、48×48、256×256），系统默认选最接近请求尺寸且不小于它的变体。但 C++ 程序若想精确获取 32×32 版本，不能依赖系统 API 返回值——LoadImage 的 cxDesired/cyDesired 是提示而非强制，实际返回可能仍是 16×16。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 遍历所有目录项，用
dwImageOffset定位各自图像数据起始位置 - 按
bWidth × bHeight × (wBitCount / 8)计算图像区大小，避开后续目录项干扰 - 若需缩放，务必在解码后用双线性插值（非最近邻），否则小图标放大后锯齿严重
内存布局和字节序陷阱容易导致跨平台崩溃
ICO 是小端序文件，但某些嵌入式平台或自定义流读取时未设 std::ios::binary 模式，会触发 CR/LF 自动转换，导致 dwImageOffset 偏移错乱。更隐蔽的是 Windows API 返回的 HICON 内部像素排列是 top-down BGRX，而 OpenCV 默认 bottom-up BGR，直接 memcpy 会垂直翻转。
- 打开文件必须用
std::ios::binary，且读取后验证dwBytesInRes是否与实际读取字节数一致 - 32 位 XOR mask 的每行字节数 =
width * 4，但 Windows 要求每行按 4 字节对齐，不足时补 0 —— 这些填充字节必须跳过，否则下一行偏移错误 - Linux 下无
HICON，建议输出为std::vector<:uint8_t></:uint8_t>的 RGBA 像素数组，便于对接 OpenGL 或 Skia
真正麻烦的不是读取，而是确认你拿到的是「那个尺寸」「那个色深」的原始像素——目录项、mask 合成、对齐填充，三处任一出错，图像就花一块或偏一格。动手前先用十六进制编辑器对照 [MSDN ICO spec](https://learn.microsoft.com/en-us/windows/win32/api/winuser/ns-winuser-icondir) 看几个真实文件，比看十篇教程都管用。
