当前位置：首页 > news >正文

clipboardy跨平台兼容性解析：支持macOS、Windows、Linux的完整解决方案

news 2026/5/15 9:38:00

clipboardy跨平台兼容性解析：支持macOS、Windows、Linux的完整解决方案

【免费下载链接】clipboardyAccess the system clipboard (copy/paste)项目地址: https://gitcode.com/gh_mirrors/cl/clipboardy

clipboardy是一款功能强大的跨平台剪贴板工具，能够让开发者轻松实现系统剪贴板的访问（复制/粘贴）功能。它支持macOS、Windows、Linux（包括Wayland）、OpenBSD、FreeBSD、Android（配合Termux）以及现代浏览器等多种环境，为不同平台的剪贴板操作提供了统一且便捷的接口。

快速安装指南

要在项目中使用clipboardy，只需通过npm进行安装，简单快捷：

npm install clipboardy

安装完成后，你就可以在项目中引入并使用clipboardy提供的各种剪贴板操作功能了。

核心功能与基础用法

文本剪贴板操作

clipboardy提供了简洁的API来进行文本的复制和粘贴操作，支持异步和同步两种方式。

异步操作示例：

import clipboard from 'clipboardy'; // 写入文本到剪贴板 await clipboard.write('🦄'); // 从剪贴板读取文本 const content = await clipboard.read(); //=> '🦄'

同步操作示例（浏览器环境不支持）：

// 同步写入文本 clipboard.writeSync('🦄'); // 同步读取文本 const content = clipboard.readSync(); //=> '🦄'

图片剪贴板操作（macOS专属）

在macOS平台上，clipboardy还提供了图片剪贴板操作的功能，包括写入图片、读取图片和检查剪贴板中是否有图片。

// 写入图片到剪贴板 await clipboard.writeImages(['/path/to/image.png']); // 读取剪贴板中的图片 const filePaths = await clipboard.readImages(); // 检查剪贴板中是否有图片 const hasImages = await clipboard.hasImages();

跨平台兼容性实现机制

Linux系统

在Linux系统中，clipboardy的实现位于lib/linux.js文件。它默认使用xsel工具来进行剪贴板操作，同时在fallbacks/linux/目录下提供了xsel的备用二进制文件。当系统中没有安装xsel时，会自动使用备用二进制文件。

对于Wayland会话，clipboardy能够自动检测，并在可用时使用wl-clipboard工具。如果wl-clipboard不可用，它会优雅地回退到X11工具。这使得clipboardy在Linux系统上具有良好的兼容性和稳定性。

Windows系统

Windows系统的实现代码在lib/windows.js中。clipboardy首先尝试使用原生的PowerShell cmdlets（Set-Clipboard/Get-Clipboard）来进行剪贴板操作。当PowerShell不可用或受到限制时，会回退到fallbacks/windows/目录下提供的二进制文件，如clipboard_x86_64.exe等，以确保在各种Windows环境下都能正常工作。

macOS系统

macOS系统的剪贴板功能由lib/macos.js文件实现。它充分利用了macOS系统的特性，不仅支持文本剪贴板操作，还提供了图片剪贴板操作的功能，这是其他平台所不具备的。

其他平台支持

除了上述主要平台外，clipboardy还对Termux（Android）、WSL等特殊环境提供了支持，分别通过lib/termux.js和lib/wsl.js文件实现。同时，browser.js文件为现代浏览器环境提供了剪贴板操作的支持，不过需要注意的是，浏览器环境需要安全上下文（HTTPS），且不支持同步方法。

常见问题解答

在无显示器的Linux环境中能使用吗？

不能。Linux上的剪贴板操作需要显示服务器（X11或Wayland）。像CI服务器、Docker容器或没有桌面环境的Raspberry Pi等无显示器环境没有系统剪贴板，因此无法使用clipboardy的剪贴板功能。

捆绑的二进制文件的来源在哪里？

Linux二进制文件fallbacks/linux/xsel是xsel的捆绑版本。Windows二进制文件（如fallbacks/windows/clipboard_x86_64.exe）的源代码可以在相关仓库找到。这些二进制文件确保了在没有安装相应系统工具时，clipboardy仍能正常工作。