pyperclip.copy() 失败但不报错主因是系统工具缺失或权限限制：windows 非原生终端、macos 缺 pbcopy、linux 缺 xclip/wl-clipboard、ssh 无图形环境；paste() 仅读 text/plain，多线程需加锁，换行符与不可见字符易致格式错乱。
pyperclip.copy() 写入失败但不报错，粘贴却没内容
这基本不是代码写错了，而是底层系统工具缺失或权限卡住。Windows 上常见于 VS Code 终端、Git Bash 这类非原生终端——它们默认不暴露系统剪贴板句柄；macOS 缺 pbcopy（重装 Xcode 命令行工具或运行 xcode-select --install）；Linux 缺 xclip 或 wl-clipboard（Ubuntu 执行 sudo apt install xclip，Wayland 环境则用 sudo apt install wl-clipboard 并调用 pyperclip.set_clipboard("wl-clipboard")）。
远程 SSH 会话中直接跑 pyperclip.copy() 必然静默失效，因为没图形环境，它 fallback 到纯文本模拟，实际不触达系统剪贴板。
- 先手动 Ctrl+V 确认剪贴板里真有文字，排除“以为复制了但其实没成功”的假象
- 避免在 Ditto、CopyQ 等剪贴板管理器开启“延迟加载”模式下测试
- Windows 下若用精简版 PowerShell，换到 CMD 或 Windows Terminal 重试
pyperclip.paste() 返回空或旧内容
它只读 text/plain 格式，复制图片、富文本、HTML 或二进制数据时，pyperclip.paste() 就是空的——这不是 bug，是设计如此。你得自己确认当前系统剪贴板里存的是纯文本。
多线程环境下尤其危险：pyperclip 内部无锁，两个线程同时调用 paste() 和 copy() 可能读到中间态或冲突结果。
- 不要跨线程共享同一个
pyperclip调用点，每个线程应独占调用或加业务层互斥 - Linux + GNOME + Wayland？
xclip读不到剪贴板，必须切wl-clipboard并显式设置：pyperclip.set_clipboard("wl-clipboard") - 执行前加个
time.sleep(0.1)避免刚复制完立刻读，某些桌面环境有微小延迟
复制含换行、中文、全角符号时格式错乱
错乱根源不在编码本身，而在换行符混用和不可见字符。Windows 习惯用 \r\n，macOS/Linux 用 \n，而部分终端或编辑器对 \r 处理异常；中文没问题，但夹带 \u200b（零宽空格）、\ufeff（BOM）、全角空格或制表符就会触发截断或渲染异常。
macOS 上粘贴后首行缩进异常？大概率是字符串开头多了不可见空格，用 repr(text) 一眼就能看到真实内容。
- 写入前统一清理：
text.replace('\r\n', '\n').replace('\r', '\n').strip() - 别传
bytes给pyperclip.copy()，它只接受str，否则抛TypeError - 避免手动拼接含 BOM 或控制字符的字符串，尤其是从网页或 PDF 复制过来的内容
需要“复制后立刻清空”或“过滤后覆盖原内容”
pyperclip 没事务、没原子性、没钩子机制。所谓“复制后立刻清空”，只能靠业务逻辑兜底：先 paste() 拿旧值 → 做清洗 → copy() 写新值。中间若被其他程序抢占剪贴板，就真的丢了。
实时监控剪贴板变化（比如监听 Ctrl+C）也无法用 pyperclip 实现——它不提供事件回调。可行方案是轮询：while True: new = pyperclip.paste(); if new != last: do_something(new); last = new; time.sleep(0.3)，但注意别太密，避免 CPU 占用高。
- 轮询间隔建议 ≥300ms，太短在 macOS 上可能被系统限频
- 过滤逻辑务必前置校验：
if not isinstance(text, str) or not text.strip(): continue - 涉及正则替换（如删后缀
(￢_￢)瞄）时，用re.sub(r'\(￢_￢\)瞄$', '', text)，锚定行尾更安全
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
