clipboard history 插件必须通过 package control 安装，手动安装90%失败；默认快捷键 ctrl+shift+v 与内置功能冲突，需改为 ctrl+alt+v；它仅监听 sublime 内纯文本复制，不支持系统级剪贴板、富文本或外部工具复制。
Clipboard History 插件必须用 Package Control 安装
手动下载 ZIP 解压到 Packages/ 目录，90% 会失败——不是路径错，就是 Python 版本不匹配（Sublime Text 4 默认用 Python 3.8，老插件可能依赖 3.3），还常缺 sublime_lib 这类隐式依赖。唯一可靠路径是走 Package Control：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入
Install Package，回车等待列表加载完成 - 搜
Clipboard History（注意中间有空格，不是ClipboardHistory或Advanced Clipboard） - 点击安装，装完不用重启
如果装完没反应，按 Ctrl+` 打开控制台，看到 ImportError: No module named 'yaml' 就说明装的是阉割版，重装即可。
默认快捷键 Ctrl+Shift+V 一定冲突，必须改
这个组合键在 Sublime 内置功能里是「粘贴并缩进」，和插件的「唤出历史列表」完全重叠。你按下去根本看不到菜单，只会发现代码被自动缩进了——这是最常被误判为“插件失效”的原因。
- 进
Preferences → Key Bindings，在右侧用户配置文件中添加：{ "keys": ["ctrl+alt+v"], "command": "paste_from_history" } - 顺手加清空命令：
{ "keys": ["ctrl+alt+d"], "command": "clear_clipboard_history" } - 改完保存立刻生效；若仍无效，先关掉 QQ、微信、Ditto 等系统级剪贴板工具——它们会劫持全局快捷键
它只记录 Sublime 内可感知的纯文本复制操作
这个插件靠监听 on_post_text_command 事件捕获内容，能力边界非常明确：
- 系统截图、PDF 文字提取、浏览器右键「复制图片地址」等操作，不会触发事件，也不会进历史
- 复制带样式的 HTML 片段后，粘贴出来只剩文字——不存格式、颜色、富文本
- 默认上限
max_items是 100 条；设太高（比如 >500）会导致弹出菜单明显卡顿，尤其老机器 - 修改上限需进
Preferences → Package Settings → Clipboard History → Settings – User，填 JSON：{"max_items": 50}
别把它当 Ditto 用，它只是 Sublime 内部轻量监听器
真正麻烦的不是装不上，而是误以为它能全局接管剪贴板。它只管 Sublime 内部发生的复制行为，离开编辑器就失效。复制内容时如果用了外部工具（比如双击选中后按 Ctrl+C，但焦点不在 Sublime 窗口），或者用了非标准复制路径（如拖拽文本后右键复制），它都捕获不到。
历史列表弹出后支持模糊搜索（直接输关键词过滤）、方向键切换、鼠标点击插入——这些功能都正常，但前提是内容得先进来。边界意识比快捷键设置更重要。
