脚本如何操作剪贴板内容

wen 实用脚本 2026-06-30 28

本文目录导读：

脚本如何操作剪贴板内容

浏览器环境脚本 (JavaScript)
非浏览器环境脚本
注意事项与最佳实践
总结选择表

操作剪贴板是现代 Web 应用常见的需求（如复制链接、粘贴文本），在浏览器中，主要有两种实现方式：现代异步 API（推荐）和传统方式（兼容旧浏览器）。

以下从前后端两个视角（主要是前端）以及脚本类型（浏览器脚本、Node.js 脚本、系统脚本）来详细说明。

浏览器环境脚本 (JavaScript)

这是最常用的场景,用于网页或浏览器扩展。

推荐方式：`Clipboard API`（异步，安全）

这是 W3C 标准，现代浏览器普遍支持，所有操作返回 Promise，需要 HTTPS 或 localhost 环境。

常用操作：

// 1. 写入文本
async function copyToClipboard(text) {
  try {
    await navigator.clipboard.writeText(text);
    console.log('内容已复制到剪贴板:', text);
    return true;
  } catch (err) {
    console.error('复制失败: ', err);
    return false;
  }
}
// 2. 读取文本
async function pasteFromClipboard() {
  try {
    const text = await navigator.clipboard.readText();
    console.log('从剪贴板读取的内容:', text);
    return text;
  } catch (err) {
    console.error('读取剪贴板失败: ', err); // 权限不足或剪贴板为空
    return null;
  }
}
// 3. 写入任意数据（如图片、HTML）
async function copyRichData(blob, mimeType) {
  try {
    const clipboardItem = new ClipboardItem({
      [mimeType]: blob
    });
    await navigator.clipboard.write([clipboardItem]);
    console.log('富内容已保存至剪贴板');
  } catch (err) {
    console.error('写入富内容失败: ', err);
  }
}
// 使用示例
copyToClipboard('Hello, 脚本！');

权限要求：

写入一般不需要明确权限，但必须在用户手势事件（如 click）触发时调用。
读取必须获得 clipboard-read 权限（通过 navigator.permissions.query({name: 'clipboard-read'}) 检查）。

传统兼容方案：`document.execCommand('copy')`（同步，已废弃但仍广泛使用）

兼容 IE 和非常老的浏览器,但会阻塞页面。

function fallbackCopyToClipboard(text) {
  // 创建一个隐藏的 textarea 元素
  const textArea = document.createElement('textarea');
  textArea.value = text;
  // 避免页面滚动
  textArea.style.position = 'fixed';
  textArea.style.opacity = '0';
  document.body.appendChild(textArea);
  textArea.focus();
  textArea.select();
  try {
    const successful = document.execCommand('copy');
    document.body.removeChild(textArea);
    if (successful) {
      console.log('复制成功（传统方式）');
      return true;
    } else {
      console.error('复制失败');
      return false;
    }
  } catch (err) {
    document.body.removeChild(textArea);
    console.error('复制异常:', err);
    return false;
  }
}

浏览器扩展脚本（如 Chrome Extension）

在扩展的 background.js 或 content_script.js 中，除了使用 navigator.clipboard，还可以使用 chrome.extension.sendMessage 或 clipboard 权限声明。

manifest.json 需要声明权限：

{
  "permissions": ["clipboardRead", "clipboardWrite"]
}

在 content script 中：

// 在用户交互的上下文中，可以使用上述两种方式
// 或调用扩展特有的 API
document.addEventListener('copy', (event) => {
  event.clipboardData.setData('text/plain', '自定义内容');
  event.preventDefault(); // 阻止默认行为
});

非浏览器环境脚本

Node.js 脚本

Node.js 本身没有标准的剪贴板 API,需要借助系统命令或第三方库。

使用 shell 命令

利用 child_process.exec 调用系统剪贴板命令。

const { exec } = require('child_process');
function copyToClipboard(text) {
  // Windows
  if (process.platform === 'win32') {
    exec(`echo ${text.replace(/"/g, '\\"')} | clip`, (err) => {
      if (err) console.error(err);
    });
  } 
  // macOS
  else if (process.platform === 'darwin') {
    const proc = require('child_process').spawn('pbcopy');
    proc.stdin.write(text);
    proc.stdin.end();
  } 
  // Linux (需要 xclip 或 xsel)
  else {
    exec(`echo "${text.replace(/"/g, '\\"')}" | xclip -selection clipboard`, (err) => {
      if (err) console.error('请安装 xclip: sudo apt-get install xclip');
    });
  }
}
// 读取剪贴板
function pasteFromClipboard() {
  return new Promise((resolve, reject) => {
    if (process.platform === 'win32') {
      exec('powershell -Command "Get-Clipboard"', (err, stdout) => {
        if (err) reject(err);
        else resolve(stdout.trim());
      });
    } else if (process.platform === 'darwin') {
      exec('pbpaste', (err, stdout) => resolve(stdout.trim()));
    } else {
      exec('xclip -selection clipboard -o', (err, stdout) => resolve(stdout.trim()));
    }
  });
}
// 使用
copyToClipboard('Hello from Node.js');
pasteFromClipboard().then(console.log);

第三方库 clipboardy（推荐）

跨平台,封装了上述系统命令。

npm install clipboardy

const clipboardy = require('clipboardy');
clipboardy.writeSync('Hello Node');
// 或异步
await clipboardy.write('Hello Async');
const text = clipboardy.readSync();
console.log(text);

系统脚本 (Shell/Batch)

Windows (Batch/PowerShell)

:: Batch: 复制文本到剪贴板
echo Hello World | clip
:: 读取剪贴板（只能通过临时文件）
powershell -command "Get-Clipboard"

macOS/Linux (Bash)

# 复制 (macOS)
echo "Hello" | pbcopy
# 复制 (Linux - 需要 xclip)
echo "Hello" | xclip -selection clipboard
# 读取 (macOS)
pbpaste
# 读取 (Linux)
xclip -selection clipboard -o

Python 脚本

Python 标准库不直接提供，常用第三方库 pyperclip。

pip install pyperclip

import pyperclip
# 复制
pyperclip.copy('Hello Python')
# 粘贴
text = pyperclip.paste()
print(text)

注意事项与最佳实践

权限与安全：
- 浏览器中，读取剪贴板会弹出权限请求，写入一般不需要（但必须用户主动触发）。
- 避免在无用户交互的脚本（如 setTimeout、页面加载时）中写入剪贴板,会被浏览器阻止。
错误处理：
- 总是对 navigator.clipboard.writeText() 使用 try/catch，因为用户可能拒绝权限（读取时）或浏览器策略限制（非安全上下文）。
格式支持：

现代 API 支持文本、图片、HTML 等,传统方式只支持文本。
测试环境：
- 本地 file:// 协议通常不被允许使用 Clipboard API，需使用 localhost 或 HTTPS。
兼容性：
- 对于需要支持 IE 或低版本移动浏览器的场景，使用 execCommand + Clipboard API 回退策略。

总结选择表

场景	推荐方案
现代浏览器网页	`navigator.clipboard.writeText/readText`
支持老旧浏览器	`execCommand('copy')` + 无事件触发
Node.js 脚本	`clipboardy` 库
系统快速命令 (Mac)	`pbcopy` / `pbpaste`
系统快速命令 (Linux)	`xclip` / `xsel`
系统快速命令 (Windows)	`clip` / `Get-Clipboard` (PowerShell)
Python 脚本	`pyperclip`