windows平台调用getclipboarddata前必须先调用openclipboard获取独占访问权，否则失败；需检查openclipboard返回值，配对调用closeclipboard，读取cf_unicodetext时须用globallock/globalunlock正确处理hglobal内存。
Windows平台用GetClipboardData前必须打开剪贴板
直接调用GetClipboardData会失败，因为Windows要求先调用OpenClipboard获取独占访问权。不检查返回值是常见错误——如果另一个进程正占用剪贴板（比如正在粘贴中），OpenClipboard会返回false，后续所有操作都无效。
实操建议：
- 始终用
if (!OpenClipboard(nullptr)) { /* 处理失败 */ }判断，不要忽略返回值 - 传
nullptr表示当前线程窗口句柄无关，适用于控制台程序 - 调用完必须配对
CloseClipboard()，否则其他程序可能卡住 - 剪贴板数据是全局资源，多线程访问需自行同步，通常建议在单线程中完成整套读取
读取CF_UNICODETEXT时要正确处理HGLOBAL内存
剪贴板文本默认以UTF-16编码存在，格式标识为CF_UNICODETEXT。拿到HGLOBAL句柄后不能直接当指针用，必须先用GlobalLock映射到可访问地址，且之后要GlobalUnlock释放锁——漏掉GlobalUnlock虽不崩溃，但会泄漏锁计数，长期运行可能出问题。
示例关键片段：
HGLOBAL hMem = GetClipboardData(CF_UNICODETEXT);
if (hMem) {
LPWSTR lpwStr = static_cast<lpwstr>(GlobalLock(hMem));
if (lpwStr) {
std::wstring text(lpwStr);
GlobalUnlock(hMem); // 必须调用
return text;
}
}</lpwstr>
注意：GlobalLock返回nullptr表示锁定失败，需检查；std::wstring构造时会自动截断到第一个L'<p>注意：<code>GlobalLock返回nullptr表示锁定失败，需检查；std::wstring构造时会自动截断到第一个L'\0'，符合Windows字符串惯例。
Linux下用X11的XConvertSelection需要事件循环配合
与Windows不同，X11剪贴板（PRIMARY或CLIPBOARD）是异步机制：你发请求后得等SelectionNotify事件回来才能拿到数据。没有事件循环就收不到响应，程序会卡死或直接读空。
实操要点：
- 用
XOpenDisplay(nullptr)连接X server，检查返回值是否为nullptr - 选择目标剪贴板：
CLIPBOARD对应Ctrl+V，PRIMARY对应鼠标中键粘贴 - 必须调用
XFlush确保请求发出，再进入XNextEvent等待循环 - 收到
SelectionNotify后，用XGetWindowProperty读取实际数据，注意format参数应为8（字节）、property设为XA_STRING或utf8_string_atom（推荐后者支持中文）
macOS用NSPasteboard需链接AppKit且只能在主线程
macOS不允许后台线程访问剪贴板API，NSPasteboard所有方法必须在主线程调用。控制台程序需显式创建NSApplication实例并运行循环，否则[pasteboard stringForType:NSPasteboardTypeString]返回nil。
关键限制：
- 必须链接
-framework AppKit，否则链接失败 - 即使无GUI，也要调用
NSApplicationLoad()和[NSApplication sharedApplication] -
NSPasteboardTypeString只返回UTF-8字符串，如需原始数据可用dataForType:配合NSPasteboardTypeUTF8PlainText - 沙盒应用需在entitlements中声明
com.apple.security.temporary-exception.mach-lookup.global-name，否则静默失败
跨平台代码里最容易被忽略的是线程上下文和权限配置，不是函数调用本身。Windows上忘关剪贴板、X11下没写事件循环、macOS在子线程调用——这三类错误现象高度相似（都返回空或阻塞），但根因完全不同。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
