windows平台用openclipboard+getclipboarddata读取纯文本必须严格按顺序调用：先openclipboard(null)，再isclipboardformatavailable(cf_unicodetext)，然后getclipboarddata、globallock、拷贝字符串、globalunlock，最后closeclipboard；漏掉globalunlock或closeclipboard会导致剪贴板卡死。
Windows 平台用 OpenClipboard + GetClipboardData 读取纯文本
Windows 剪贴板 API 是最直接的路径，但必须按严格顺序调用，否则会失败或阻塞其他程序。关键不是“能不能读”，而是“有没有正确释放”。常见错误是忘记 CloseClipboard，导致后续所有剪贴板操作卡死（包括 Ctrl+V 失效）。
读取纯文本（CF_TEXT 或更推荐的 CF_UNICODETEXT）时，需先 OpenClipboard(NULL)，再检查格式是否可用（IsClipboardFormatAvailable），最后用 GlobalLock 获取内存指针。注意：CF_TEXT 是 ANSI 编码，跨区域易乱码；一律用 CF_UNICODETEXT（UTF-16）。
-
OpenClipboard必须传NULL（当前线程窗口句柄不为必需） - 获取数据后，
GlobalSize返回的是字节数，不是字符数；wchar_t*指针要按sizeof(wchar_t)换算 - 必须用
GlobalUnlock解锁，再调用CloseClipboard—— 顺序错一个就泄漏
写入富文本（RTF）要用 SetClipboardData 配合 GlobalAlloc 分配可移动内存
RTF 不是字符串，是带控制字的二进制块（CF_RTF 格式）。不能直接把 std::string 指针传给 SetClipboardData；必须用 GlobalAlloc(GMEM_MOVEABLE, size) 分配内存，再 GlobalLock 写入数据，最后 GlobalUnlock。系统接管这块内存后，你不能再访问它。
常见坑：分配内存时没加结尾空字节（RTF 要求以 \0 结尾）、写入长度少一字节、忘记在 SetClipboardData 前调用 EmptyClipboard（否则旧内容残留，新数据可能被忽略）。
- RTF 字符串必须以
"{\rtf1\ansi\deff0 ... }\0"形式存在，末尾\0是硬性要求 -
SetClipboardData(CF_RTF, hMem)后，hMem所有权移交系统，你的代码不得再GlobalFree它 - 若同时支持纯文本和 RTF，应先设
CF_RTF，再设CF_UNICODETEXT—— 系统按格式优先级自动降级
Linux（X11）下用 xcb 或 Xlib 读取剪贴板分 PRIMARY 和 CLIPBOARD 两个选择区
X11 没有统一“剪贴板”概念，而是两个独立选择区：PRIMARY（鼠标中键粘贴）和 CLIPBOARD（Ctrl+C/V）。多数程序只监听后者，但终端、vim 默认用 PRIMARY。不区分二者，就会出现“复制了却粘贴不出”的问题。
用 Xlib 读 CLIPBOARD 需四步：请求所有权（XConvertSelection）、等待 SelectionNotify 事件、用 XGetWindowProperty 取数据、清理。整个过程是异步的，不能阻塞等待 —— 这和 Windows 的同步模型完全不同。
- 必须为窗口设置
SelectionRequest事件监听，否则收不到响应 - 目标格式常用
UTF8_STRING（而非STRING），避免编码歧义 -
xcb更轻量，但需手动处理事件循环；Xlib封装稍多，但隐藏了部分底层细节
macOS 用 NSPasteboard 最简单，但仅限 Objective-C++ 混合编译
C++ 原生不支持 macOS 剪贴板，必须通过 Objective-C++（.mm 文件）调用 NSPasteboard。纯 C++ 项目得封装一层桥接，否则编译不过。这不是权限问题，而是 API 绑定方式决定的。
读取时，[pasteboard stringForType:NSPasteboardTypeString] 直接返回 NSString*；写入 RTF 则用 [pasteboard setData:forType:NSPasteboardTypeRTF]。注意：RTF 数据必须是 NSData*，不能传 raw pointer。
- 必须链接
-framework AppKit，且编译器识别.mm后缀（CMake 中设set_source_files_properties(file.mm PROPERTIES LANGUAGE OBJECTIVE_CPP)） -
NSPasteboard是线程安全的，但必须在主线程调用（AppKit 限制） - 富文本支持依赖系统版本：RTF 在 macOS 10.15+ 稳定，旧版建议 fallback 到 HTML（
NSPasteboardTypeHTML）
跨平台剪贴板没有银弹。Windows 用 Win32 API 最稳，Linux 要处理异步和双选择区，macOS 强制混编。真正麻烦的不是读写本身，而是每个平台对“格式协商”“内存生命周期”“线程模型”的隐含约定——漏掉任意一条，程序就表现为“有时行，有时不行”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
