Python 自动化办公：用 pyperclip 两行代码读写剪贴板

在开发自动化办公脚本、日常小工具时，我们经常需要让 Python 脚本与系统剪贴板进行交互。例如：把程序处理好的文本自动复制，方便手动粘贴到其他软件中；或者读取刚刚复制的内容进行批量处理。

如果使用标准的 GUI 库（如 Tkinter）或系统底层 API 来操作剪贴板，代码通常较为繁琐。而 pyperclip 这个第三方库提供了极其简洁的接口，只需两行代码就能实现文本的复制与粘贴。

1. pyperclip 库简介

pyperclip 是一个跨平台的 Python 模块，专门用于复制和粘贴剪贴板上的文本。

该库的核心功能非常纯粹，主要由两个函数组成：

• pyperclip.copy(text)：将指定的字符串文本写入系统剪贴板（相当于执行 Ctrl + C）。
• pyperclip.paste()：读取当前系统剪贴板中的文本（相当于执行 Ctrl + V）。

2. 安装方法

使用 pyperclip 可通过 pip 进行安装。打开系统终端或命令行，执行：

pip install pyperclip

特别提醒：如果你使用的是 Linux 系统，可能需要额外安装剪贴板工具（如 xclip 或 xsel）作为后端支持。可以通过以下命令安装（Ubuntu 为例）：

sudo apt-get install xclip

3. 代码示例

3.1 写入剪贴板（复制）

运行以下代码后，程序会将指定的文本放入系统剪贴板。此时你在电脑的任何文本编辑器中按下粘贴快捷键，就能看到这段文本。

import pyperclip

# 将文本复制到剪贴板
pyperclip.copy("这是由 Python 写入剪贴板的文本")

print("文本已成功写入剪贴板，请尝试在其他地方粘贴。")

3.2 读取剪贴板（粘贴）

先手动复制任意一段文字，然后运行以下代码，Python 将会读取并打印出剪贴板中的内容。

import pyperclip

# 从剪贴板读取文本
text = pyperclip.paste()

print("读取到的剪贴板内容为：")
print(text)

4. 实战案例：自动清洗 PDF 复制文本的换行

在实际办公中，我们经常遇到从 PDF 文件中复制段落时，文本带有莫名其妙的强制换行，导致粘贴到翻译软件或文档中时排版错乱。

利用 pyperclip，我们可以写一个简单的脚本，监控剪贴板并自动将换行符替换为空格：

import pyperclip
import time

print("PDF文本换行清洗工具已启动，按 Ctrl + C 可退出程序...")

last_text = ""

try:
    while True:
        # 获取当前剪贴板内容
        current_text = pyperclip.paste()

        # 如果剪贴板内容发生变化，且不为空
        if current_text != last_text and current_text.strip():
            # 将换行符替换为空格
            cleaned_text = current_text.replace("\n", " ")

            # 将清洗后的文本重新写回剪贴板
            pyperclip.copy(cleaned_text)

            print(f"\n已清洗文本（原长度: {len(current_text)} -> 现长度: {len(cleaned_text)}）")

            # 更新历史记录，避免重复处理
            last_text = cleaned_text

        # 每隔 0.5 秒检查一次，避免过度占用 CPU
        time.sleep(0.5)

except KeyboardInterrupt:
    print("\n程序已安全退出。")

5. 常见问题

在实际使用过程中，初学者容易遇到以下几个问题：

（1）数据类型限制

pyperclip.copy() 函数的参数必须是字符串类型。如果直接传入整数、列表或字典（例如 pyperclip.copy(12345)），程序会抛出 TypeError 异常。因此在传入前，需要使用 str() 函数将数据转换为字符串。

（2）不支持非文本数据

pyperclip 只能处理纯文本。它无法用来复制或粘贴文件、图片或带有格式的富文本。如果你的业务场景需要处理剪贴板中的图像，需要改用 Pillow 库或系统原生的 GUI 框架。

（3）避免死循环

在编写类似上文的“监控剪贴板”程序时，必须在 while True 循环中加上 time.sleep() 延迟。否则程序会以极高的频率频繁读取内存，导致单个 CPU 核心占用率飙升至 100%。

6. 总结

pyperclip 是一个功能单一但非常实用的工具。你可以用它灵活地读写剪贴板，配合其他 Python 库和脚本，实现更丝滑的交互体验。