windows剪贴板操作必须在ui线程执行，需调用openclipboard、getclipboarddata（cf_unicodetext）、globallock等api，注意传入有效窗口句柄、检查格式可用性、正确分配/释放全局内存；控制台程序需创建隐藏窗口或改用clip.exe。
Windows平台用OpenClipboard和GetClipboardData读取文本
在Windows上，C++访问剪贴板必须通过Win32 API，且全程需在UI线程中执行（否则OpenClipboard会失败）。核心流程是：打开剪贴板 → 请求CF_UNICODETEXT格式数据 → 获取句柄 → 锁定内存并拷贝字符串。
常见错误包括：OpenClipboard(NULL)传入NULL导致失败（应传入窗口句柄或当前线程所属窗口句柄）；未检查IsClipboardFormatAvailable(CF_UNICODETEXT)就直接调用GetClipboardData，返回NULL后解引用崩溃；以及忘记GlobalUnlock或CloseClipboard，造成后续剪贴板操作被阻塞。
实操要点：
- 确保调用线程已初始化COM（如使用
CoInitializeEx(NULL, COINIT_APARTMENTTHREADED)），尤其在无窗口的控制台程序中 - 优先尝试
CF_UNICODETEXT，再回退到CF_TEXT（ANSI），避免宽字符截断 -
GlobalLock返回的是LPVOID，需强制转为LPCWSTR（UTF-16）或LPCSTR（ANSI） - 不要对
GlobalLock返回指针做delete或free——它是全局内存，由系统管理
C++写入剪贴板要用EmptyClipboard + SetClipboardData
写入比读取更易出错：必须先调用EmptyClipboard（且该调用前必须已成功OpenClipboard），否则SetClipboardData会失败并返回FALSE。关键点在于内存分配方式——必须用GlobalAlloc(GMEM_MOVEABLE | GMEM_DDESHARE, size)分配，并用GlobalLock写入内容，最后GlobalUnlock，再传给SetClipboardData。
立即学习“C++免费学习笔记（深入）”；
典型陷阱：
- 用
new或malloc分配内存后直接传给SetClipboardData→ 系统无法管理，粘贴时崩溃或乱码 - 调用
EmptyClipboard后未立刻写入，其他进程趁机抢占剪贴板 → 写入失败 - 传入
CF_TEXT但数据是UTF-16字符串 → 出现中文乱码（应统一用CF_UNICODETEXT） - 忘记在
SetClipboardData后调用CloseClipboard→ 剪贴板被锁死，其他程序无法访问
跨平台方案不能只靠Win32，Qt/SDL等框架封装更可靠
Linux（X11）和macOS有完全不同的剪贴板机制：X11依赖XOpenDisplay + XConvertSelection，macOS用NSPasteboard Objective-C API。纯C++标准库不提供跨平台剪贴板支持，硬写三端逻辑维护成本极高。
如果项目已引入第三方库，优先复用其封装：
- Qt：用
QApplication::clipboard()+text()/setText()，自动处理线程、编码、多选板（primary/clipboard） - SDL2：调用
SDL_GetClipboardText()和SDL_SetClipboardText()，内部已桥接各平台 - Boost.Process等不提供剪贴板能力，别白费力气查文档
自行实现跨平台时，务必隔离平台相关代码，用#ifdef _WIN32 / #ifdef __linux__分治，避免头文件污染和链接错误。
控制台程序调用剪贴板常因线程模型失败
Win32剪贴板API要求调用线程具备消息队列（即“可泵送线程”），而默认控制台程序主线程没有。现象是OpenClipboard始终返回FALSE，GetLastError()为0x57 (ERROR_INVALID_PARAMETER)。
解决路径只有两条：
- 改用GUI子系统：链接
/SUBSYSTEM:WINDOWS，写一个隐藏窗口（CreateWindowEx后ShowWindow(hwnd, SW_HIDE)），将剪贴板操作发往该窗口消息循环 - 不创建窗口但手动泵消息：调用
PeekMessage+TranslateMessage+DispatchMessage维持线程消息队列（较重，仅推荐短时使用）
别试图用AttachThreadInput把控制台线程“挂”到Explorer上——权限不足且不稳定。真正轻量的方案是直接用PowerShell或clip.exe命令行工具做胶水层，比如system("powershell -Command \"Get-Clipboard\"")读取，虽然慢但能跑通。
