如何使用Python读取、修改或删除Windows剪贴板全部历史记录
Windows剪贴板历史的Python操作方案
前提条件
- 首先确认你的Windows系统已经开启剪贴板历史功能:按下
Win + V可以唤起历史面板即代表已开启,未开启的话需要先在「设置 - 系统 - 剪贴板」中打开开关,唤起的面板样式如下:
- 需要用到微软官方提供的WinRT Python绑定库,安装命令:
pip install winsdk(旧版winrt包已停止维护,推荐使用最新的winsdk)
功能实现代码
1. 读取所有剪贴板历史记录
import asyncio from winsdk.windows.applicationmodel.datatransfer import Clipboard, ClipboardHistoryItemsResult async def get_clipboard_history(): # 申请剪贴板历史访问权限 access_status = await Clipboard.request_history_access_async() if access_status.value != 1: # 1对应允许访问的状态枚举值 print("无法访问剪贴板历史,请检查系统权限设置") return [] # 拉取所有历史条目 history_result: ClipboardHistoryItemsResult = await Clipboard.get_history_items_async() if not history_result.items: return [] history_list = [] for item in history_result.items: # 仅提取文本内容,图片、文件等其他格式可按需扩展对应读取方法 if item.content.available_formats.contains("Text"): text_content = await item.content.get_text_async() history_list.append({ "id": item.id, "content": text_content, "timestamp": item.timestamp.datetime }) return history_list if __name__ == "__main__": history = asyncio.run(get_clipboard_history()) for idx, item in enumerate(history): print(f"第{idx+1}条 | 复制时间:{item['timestamp']} | 内容:{item['content']}")
2. 删除指定剪贴板历史条目
需要传入对应条目的ID(可从读取接口返回的字段中获取)
async def delete_clipboard_item(item_id: str): return await Clipboard.delete_item_from_history_async(item_id) # 调用示例:asyncio.run(delete_clipboard_item("待删除条目对应的ID"))
3. 清空全部剪贴板历史
async def clear_all_clipboard_history(): return await Clipboard.clear_history_async() # 调用示例:asyncio.run(clear_all_clipboard_history())
4. 将指定历史条目设置为当前剪贴板内容
async def set_history_item_as_current(item_id: str): return await Clipboard.set_history_item_as_current_async(item_id)
注意事项
- 上述接口仅支持Windows 10 1809及以上版本,低于该版本的系统没有原生剪贴板历史功能,无法使用。
- 微软官方未开放直接修改历史条目内容的API,如需修改某条历史内容,可先读取条目内容修改后复制到剪贴板,再删除原有历史条目即可实现等效效果。
- win32clipboard、pyperclip等库仅对接了传统Windows剪贴板接口,只能访问最近一次复制的活跃剪贴板内容,因此无法读取历史记录。
内容的提问来源于stack exchange,提问作者Yash Kolekar
相关产品推荐
相关产品推荐

