Windows全屏截图最轻量方式是用GetDC(NULL)获取屏幕DC，再通过BitBlt拷贝至CreateDIBSection创建的32bpp BGRA位图，需字节重排为RGBA后调用stbi_write_png保存为PNG，并严格配对释放GDI资源。
Windows平台用GDI获取全屏图像数据
全屏截图在Windows上最轻量的方式是调用GetDC(NULL)获取整个屏幕的设备上下文，再用BitBlt把像素拷贝到兼容DC的位图中。关键点在于：必须用GetSystemMetrics(SM_CXSCREEN)和GetSystemMetrics(SM_CYSCREEN)获取真实分辨率，不能硬编码；目标位图需用CreateDIBSection创建，否则无法直接访问像素内存或保存为PNG。
常见错误是直接用GetBitmapBits读取HBITMAP——它返回的是设备相关位图（DDB），格式不固定，RGB顺序、对齐、压缩方式都不可控，后续转PNG会失败或颜色错乱。
- 务必使用
BITMAPINFO结构指定BI_RGB和32bpp（即biBitCount = 32），保证每像素4字节、含Alpha通道，方便后续处理 - 源DC和目标DC尺寸必须严格一致，否则
BitBlt可能只拷贝部分区域 - 记得用
SelectObject把位图选入目标DC，并保存原始位图句柄用于恢复
用stb_image_write保存为PNG
stb_image_write.h是单头文件库，无需编译，只需定义STB_IMAGE_WRITE_IMPLEMENTATION一次后包含即可。它接受RGBA或RGB内存块，但注意：GDI获取的DIB数据默认是BGR顺序，且Windows下高位字节是Alpha（即BGRA），而stb_image_write的stbi_write_png函数期望RGB或RGBA顺序。所以必须做字节重排。
典型错误是传入未转换的原始DIB内存，导致保存出的PNG全是紫红色或色偏严重。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 若用
stbi_write_png，传入4通道时需确保是RGBA顺序，可逐像素交换rgb三字节：swap(p[i+0], p[i+2]) - 若不想改数据，可用
stbi_write_png_compressed配合自定义写回调，但更简单的是直接用stbi_write_png并做原地翻转 - 注意
stbi_write_png第四个参数stride_in_bytes应为width * 4，不是width * 3
完整流程中的资源释放与错误检查
Windows GDI对象不自动释放，漏掉DeleteObject或ReleaseDC会导致句柄泄漏，多次截图后程序可能卡死或报ERROR_INVALID_HANDLE。同时，stbi_write_png失败时只返回0，无详细错误信息，需靠返回值判断。
- 所有
HDC必须配对ReleaseDC，即使获取失败也要判空 -
HBITMAP创建成功后，必须用DeleteObject释放，不能只靠作用域结束 - 调用
stbi_write_png前确认输出路径可写，文件名含中文时需用std::filesystem::u8path或转为UTF-8宽字符 - 截图区域若跨多显示器（如扩展模式），
GetSystemMetrics(SM_CXSCREEN)只返回主屏宽度，此时应改用GetSystemMetrics(SM_XVIRTUALSCREEN)等系列API
Linux/macOS下不能直接套用这套逻辑
这段代码完全依赖Windows GDI API，在Linux上GetDC、BitBlt根本不存在；macOS也没有对应接口。如果需要跨平台，得换方案：Linux可用XShmGetImage（X11）或gbm+DRM（Wayland），macOS得走CGDisplayCreateImage。别试图用条件编译硬塞GDI代码进去——链接阶段就会报undefined reference。
哪怕只是临时Windows工具，也建议把GDI操作封装成独立函数，避免和PNG保存逻辑混在一起。这样以后替换成其他截图后端时，只要重写这个函数就行。
