为何pyperclip.copy函数仅在代码设断点时才能正常工作？

问题场景 #

Fedora 37系统，在VS Code中调试Python代码时，调用pyperclip.copy()复制文本到剪贴板：

• 未设置断点：复制操作无效果
• 设置断点后：复制正常工作

相关核心代码：

def process_and_write_results(mocr, img_or_path, write_to):
    t0 = time.time()
    text = mocr(img_or_path)
    t1 = time.time()

    logger.info(f'Text recognized in {t1 - t0:0.03f} s: {text}')

    if write_to == 'clipboard':
        pyperclip.copy(text)  # 问题出在这里
    else:
        write_to = Path(write_to)
        if write_to.suffix != '.txt':
            raise ValueError('write_to must be either "clipboard" or a path to a text file')

        with write_to.open('a', encoding="utf-8") as f:
            f.write(text + '\n')

解决方案 #

1. 增加延时确保剪贴板操作完成 #

在pyperclip.copy()后添加短暂延时，给剪贴板服务足够时间处理数据写入：

import time

# ... 原有代码 ...

if write_to == 'clipboard':
    pyperclip.copy(text)
    time.sleep(0.1)  # 延时100毫秒，可根据实际情况调整

2. 改用系统原生剪贴板工具（适配Wayland/X11） #

Fedora默认使用Wayland桌面环境，pyperclip对Wayland的支持存在局限性，可直接调用系统剪贴板工具：

• Wayland环境：使用wl-copy（需先安装wl-clipboard包）

  import subprocess
  
  # ... 原有代码 ...
  
  if write_to == 'clipboard':
      subprocess.run(['wl-copy'], input=text.encode('utf-8'), check=True)
  

• X11环境：使用xclip（需先安装xclip包）

  import subprocess
  
  # ... 原有代码 ...
  
  if write_to == 'clipboard':
      subprocess.run(['xclip', '-selection', 'clipboard'], input=text.encode('utf-8'), check=True)
  

安装依赖包：

sudo dnf install wl-clipboard xclip

3. 调整VS Code调试控制台配置 #

修改.vscode/launch.json，让程序在终端环境运行，改善剪贴板交互：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"  // 或改为"externalTerminal"
        }
    ]
}

原因说明 #

这种现象的核心是程序退出时机与剪贴板操作的异步性冲突：

• 无断点时，程序执行完pyperclip.copy()后立刻退出，剪贴板服务尚未完成数据写入操作，导致复制失效；
• 设置断点后，程序暂停，给了剪贴板足够的时间完成数据同步；
• 另外Fedora的Wayland环境下，剪贴板数据依赖于发起操作的进程存活状态，进程提前退出会直接导致剪贴板数据丢失。

内容的提问来源于stack exchange，提问作者Cute pumpkin