Windows需严格按OpenClipboard→EmptyClipboard→GlobalAlloc→GlobalLock→复制UTF-16→GlobalUnlock→SetClipboardData→CloseClipboard顺序操作；Linux推荐xclip或wl-copy；macOS须链接AppKit并处理隐私授权；跨平台优先用cpp-clipboard或SDL2。

Windows平台用OpenClipboard + SetClipboardData写入文本

Windows API 提供了直接操作剪贴板的底层能力，但必须严格按顺序调用，否则SetClipboardData会失败并返回NULL。常见错误是忘记清空旧内容、未分配全局内存、或在CloseClipboard前释放内存。

关键步骤：

• 调用OpenClipboard(NULL)获取剪贴板所有权（失败则退出）
• 调用EmptyClipboard()清除当前内容（这步漏掉会导致写入失败）
• 用GlobalAlloc(GMEM_MOVEABLE, size)分配可移动全局内存，大小需包含结尾的\0
• 用GlobalLock获取指针，复制UTF-16编码的字符串（Windows剪贴板文本要求CF_UNICODETEXT）
• 调用GlobalUnlock，再调用SetClipboardData(CF_UNICODETEXT, hMem)
• 最后CloseClipboard()释放所有权

注意：输入字符串如果是UTF-8，必须先转为UTF-16（可用MultiByteToWideChar(CP_UTF8, ...)）；直接传char*会导致乱码或崩溃。

Linux下用X11的XStoreBytes或xclip命令更可靠

X11协议本身不提供标准剪贴板API，原生C++调用XStoreBytes只能写入“服务器剪贴板”（PRIMARY），用户通常感知不到；真正对应Ctrl+C/V的是CLIPBOARD选择区，需手动实现选择区协议（含INCR、UTF8_STRING等原子协商），复杂度高且易出错。

实操建议：

• 开发阶段直接调用外部工具：用std::system("echo 'text' | xclip -selection clipboard -in -f")（需安装xclip）
• 若坚持纯C++，推荐使用libxcb封装库如xcb-util-xrm或更高层的gtk_clipboard_set_text（但会引入GTK依赖）
• xclip默认超时短，长文本可能失败，加-t 1000延长等待时间

注意：xclip在Wayland会失效，此时应改用wl-clipboard（命令为wl-copy）。

macOS用NSPasteboard需链接AppKit框架

macOS不允许后台进程随意访问剪贴板，必须链接AppKit且运行在主线程（或至少有NSApplication实例）。直接从控制台程序调用会静默失败——[NSPasteboard generalPasteboard]返回nil，但无错误提示。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

正确做法：

• 项目需链接-framework AppKit，CMake中加target_link_libraries(your_target "-framework AppKit")
• 确保NSApplicationLoad()已调用（CLI程序需手动触发）
• 写入代码简洁：[[NSPasteboard generalPasteboard] clearContents]; [[NSPasteboard generalPasteboard] setString:@"text" forType:NSPasteboardTypeString];
• 字符串自动处理编码，无需手动转UTF-16/UTF-8

注意：macOS 10.14+ 对后台程序剪贴板访问有隐私限制，首次运行会弹窗请求授权；若拒绝，后续调用不报错但无效。

跨平台方案别自己造轮子，用cpp-clipboard或SDL2

硬写三平台剪贴板逻辑极易遗漏细节：Windows内存管理、X11选择区状态同步、macOS权限弹窗时机。已有成熟轻量库能覆盖95%场景。

推荐选择：

• cpp-clipboard（头文件仅clipboard.h）：内部自动检测平台，Windows用API，Linux调xclip/wl-copy，macOS用NSPasteboard；支持UTF-8输入，自动处理编码转换
• SDL2（若项目已用SDL）：调SDL_SetClipboardText("text")即可，跨平台且无额外依赖，但需初始化SDL子系统（SDL_Init(SDL_INIT_VIDEO)）
• 避免用Qt的QClipboard：除非整个项目基于Qt，否则引入庞大依赖不划算

真实坑点：某些Linux发行版默认没装xclip或wl-copy，部署时需检查命令是否存在，否则cpp-clipboard会静默回退到失败状态，建议加一层which xclip校验。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！