CopyQ：带编辑与脚本功能的高级剪贴板管理器 #

CopyQ 是什么？ #

CopyQ 是一款带有编辑和脚本功能的高级剪贴板管理器，兼容 Linux、Windows 和 macOS 10.15+ 系统。它会持续监控系统剪贴板，并把每一次复制的内容自动保存到可自定义的标签页中，用户可以随时回溯、检索并重新粘贴这些历史记录。

与系统自带的单条剪贴板不同，CopyQ 能够存储文本、HTML、图片以及任意自定义格式的数据，允许用户对历史条目进行排序、编辑、删除、拖拽整理、添加备注或标签。它还提供系统级快捷键、完全可定制的外观、强大的命令行与脚本接口，以及 Vim 风格的编辑器，适合需要频繁复制粘贴、管理大量文本片段的开发者、文案工作者和办公用户。

CopyQ 有哪些亮点特色？ #

• 多格式剪贴板捕获：不仅保存纯文本，还支持 HTML、图片以及任何自定义 MIME 格式，复制网页表格、代码片段或图片都能原样保留。
• 标签页分类管理：剪贴板历史保存在可自定义的标签页中，用户可以为不同场景建立独立分类，并在标签间快速切换、整理内容。
• 实时搜索与过滤：面对成百上千条历史记录，可通过关键字快速过滤定位所需条目，免除逐条翻找的麻烦。
• 系统级快捷键与可编程命令：支持为任意操作绑定全局快捷键，配合内置命令系统，可在剪贴板变化时自动触发自定义动作。
• 强大的命令行与脚本接口：提供 copyq 命令行工具与脚本 API，可通过脚本批量添加、读取、写入剪贴板内容，实现自动化工作流。
• 丰富的条目编辑能力：历史条目支持编辑（F2）、删除（Delete）、排序（Ctrl+Shift+S / Ctrl+Shift+R）、鼠标或 Ctrl+Up/Down 移动、复制回剪贴板（Ctrl+C）与直接粘贴（Enter）。
• 可定制外观与 Vim 式编辑：界面主题完全可自定义，并内置简单易用的类 Vim 编辑器与快捷键，满足键盘流用户的操作习惯。
• 智能忽略规则：可设置忽略来自某些窗口的剪贴板内容，或忽略包含特定文本的复制操作，避免密码等敏感信息被记录。

免费下载 CopyQ #

以下为官方提供的各平台安装包，点击链接即可下载。

提示：官网同时提供 Scoop、Chocolatey、Homebrew、APT、DNF、Pacman 与 Flatpak 等包管理方式，可根据自身系统选择。

CopyQ 如何使用？ #

1. 启动程序：双击程序图标，或直接在终端/命令行中运行 copyq 命令启动应用。

2. 打开剪贴板历史：点击系统托盘图标，或运行 copyq toggle 命令，即可展开剪贴板历史列表。

3. 正常复制即可记录：在任意应用中复制文本或图片，CopyQ 会自动在列表顶部生成一个新的条目。

4. 操作选中条目：

   • 编辑条目：按 F2
   • 删除条目：按 Delete
   • 排序条目：Ctrl+Shift+S（升序）、Ctrl+Shift+R（降序）
   • 移动条目：鼠标拖拽或按 Ctrl+Up/Down
   • 复制回剪贴板：按 Ctrl+C
   • 粘贴到先前活动窗口：按 Enter

5. 创建自定义命令：按 F6 打开命令对话框，点击 Add 按钮选择预设命令或新建命令，可为其设置快捷键与名称，点击 OK 保存。例如"显示/隐藏主窗口"就是非常实用的预设命令之一。

6. 使用命令行接口（需主程序正在运行）：

   copyq --help                # 查看可用参数
   copyq add -- 'a' 'b' 'c'    # 添加多条文本条目
   copyq read 0 1 2            # 读取前三条内容
   copyq clipboard             # 查看当前剪贴板内容
   copyq copy "Some Text"      # 将文本写入剪贴板
   copyq copy image/jpeg - < image.jpg   # 将图片写入剪贴板
   

7. 退出程序：在托盘菜单中选择 Exit，或在应用窗口中按 Ctrl-Q。

所有条目在下次启动应用时都会自动恢复，无需担心历史记录丢失。

CopyQ 的常见问题？ #

CopyQ 是否免费？ CopyQ 是完全开源且免费的软件，由 hluk 维护并在 GitHub 上公开发布源码，用户可以自由使用、修改和分发，没有任何功能限制或付费门槛。

CopyQ 支持哪些操作系统？ 官方支持 Linux、Windows 以及 macOS 10.15 及以上版本。Linux 用户可通过 Debian/Ubuntu 软件源、Fedora、Arch、Flatpak 等多种方式安装；Windows 用户可使用 setup.exe 安装包、便携版 zip、Scoop 或 Chocolatey；macOS 用户可通过 Homebrew 安装。

为什么我复制的部分内容没有被记录？ 可能是触发了 CopyQ 的忽略规则。CopyQ 允许用户设置忽略来自某些窗口的剪贴板内容，或忽略包含特定文本的复制操作，这通常是为保护密码等敏感信息而设计的，可在设置中检查相关规则。

如何查看或管理剪贴板历史？ 点击系统托盘图标即可打开历史列表，或在命令行执行 copyq toggle。在列表中可对条目进行编辑、删除、排序、移动、批量复制和粘贴等操作，操作方式详见上文"如何使用"部分。

命令行提示无法执行命令怎么办？ CopyQ 的主程序必须处于运行状态，命令行工具才能正常工作。请先启动 CopyQ（托盘中出现图标），再执行 copyq 相关命令。

CopyQ 的历史记录会丢失吗？ 不会。CopyQ 会在每次启动时自动恢复之前保存的所有条目，历史数据在正常退出与重启后依然保留。

CopyQ 如何安装？ #

Windows #

1. 安装程序方式：下载 copyq-16.0.0-setup.exe，双击运行并按向导完成安装。
2. 便携版：下载官方 Portable zip 包，解压后直接运行，无需安装。
3. Scoop：执行 scoop install copyq（需先添加 extras bucket）。
4. Chocolatey：执行 choco install copyq。

macOS #

1. 使用 Homebrew 一键安装：

   brew install --cask copyq
   

2. 也可下载本页提供的 .dmg 安装包（注意区分 macOS 12 M1 与 macOS 13 版本），打开后将 CopyQ 拖入"应用程序"文件夹。

Linux #

• Debian 10+ / Ubuntu 18.04+ 及其衍生版：安装 copyq 软件包，强烈建议同时安装 copyq-plugins，另有 copyq-doc 可用。

• Ubuntu PPA（保持最新版本）：

  sudo add-apt-repository ppa:hluk/copyq
  sudo apt update
  sudo apt install copyq
  

• Fedora：安装 copyq 软件包。

• Arch Linux：安装 copyq 软件包。

• 其他发行版：安装 Flatpak 后执行

  flatpak install flathub com.github.hluk.copyq
  flatpak run com.github.hluk.copyq
  

从源码编译 #

如需在未列出的系统上安装，可自行编译：安装 Git、CMake、Qt 等依赖（Ubuntu 与 RHEL/CentOS/Oracle Linux 的依赖命令参见官方文档），随后执行：

git clone https://github.com/hluk/CopyQ.git
cd CopyQ
cmake .
make
./copyq

CopyQ 如何卸载？ #

Windows #

1. 打开"控制面板 → 程序和功能"（或"设置 → 应用"）。
2. 找到 CopyQ，点击"卸载"并按照提示完成卸载。
3. 若使用 Scoop 或 Chocolatey 安装，可分别执行 scoop uninstall copyq 或 choco uninstall copyq。

macOS #

1. 若通过 Homebrew 安装，执行：

   brew uninstall --cask copyq
   

2. 若通过 DMG 安装，打开"应用程序"文件夹，将 CopyQ 拖入废纸篓并清空即可。

Linux #

• APT 系（Debian/Ubuntu）：

  sudo apt remove copyq
  sudo apt purge copyq        # 同时移除配置文件
  

• Fedora：执行 sudo dnf remove copyq。

• Arch Linux：执行 sudo pacman -Rns copyq。

• Flatpak：

  flatpak uninstall com.github.hluk.copyq
  

提示：部分平台卸载后可能在用户目录中残留配置与历史记录文件（例如 Linux 下的 ~/.config/copyq），如需彻底清理可手动删除对应目录。卸载前建议先备份重要的剪贴板历史数据。