Maccy完全指南：从安装到精通的一站式用户手册

你是否还在为频繁切换窗口复制粘贴而烦恼？是否经常忘记刚刚复制的内容？Maccy作为一款轻量级macOS剪贴板管理器，让这些问题成为过去。本文将带你从安装到精通，全面掌握这款效率工具的使用技巧，让你的工作流效率提升300%。

安装指南：3种方式快速上手

Maccy提供多种安装方式，选择最适合你的一种：

官方发布版

直接从发布页面下载最新版本，解压后将Maccy拖入应用程序文件夹即可。

Homebrew安装

使用Homebrew的用户可以通过一行命令完成安装：

brew install maccy

源码编译

开发者可以通过克隆仓库自行编译：

git clone https://gitcode.com/gh_mirrors/ma/Maccy.git
cd Maccy
xcodebuild

详细安装说明可参考项目README.md

基础操作：5分钟上手核心功能

Maccy采用键盘优先设计，掌握这些基础操作让你效率倍增：

唤出剪贴板历史

默认使用 ⇧ Shift + ⌘ Command + C 快捷键唤出历史记录面板，也可以点击菜单栏图标打开。

基本导航操作

• 搜索过滤：唤出后直接输入关键词筛选历史内容
• 选择项目：使用 ↑ ↓ 箭头键导航，Enter 复制选中项
• 直接粘贴：按住 ⌥ Option + Enter 可直接粘贴选中内容
• 纯文本粘贴：按住 ⌥ Option + ⇧ Shift + Enter 粘贴为纯文本

高级技巧：让效率更进一步

掌握这些高级功能，解锁Maccy全部潜力：

固定常用内容

遇到需要反复使用的内容？选中项目后按 ⌥ Option + P 将其固定在列表顶部，并自动分配快捷键。固定项会显示特殊标记，方便识别。

固定功能由 HistoryItem.swift 模块实现，支持永久保存重要内容

智能忽略功能

Maccy能自动忽略敏感内容和临时数据，保护你的隐私：

• 按住 ⌥ Option 点击菜单栏图标可暂时禁用剪贴板记录
• 按住 ⌥ Option + ⇧ Shift 点击可忽略下一次复制操作
• 通过终端命令设置全局忽略：

defaults write org.p0deje.Maccy ignoreEvents true

自定义快捷键

在偏好设置中，你可以自定义所有操作的快捷键。进入偏好设置的方法：

1. 唤出Maccy后按 ⌘ Command + ,
2. 或通过菜单栏图标 → 偏好设置
3. 在"快捷键"标签页进行自定义

快捷键管理由 GlobalHotKey.swift 和 KeyShortcut.swift 模块处理

个性化配置：打造专属工具

Maccy提供丰富的自定义选项，让工具更符合你的使用习惯：

外观定制

在偏好设置的"外观"面板，你可以调整：

• 窗口大小和位置
• 历史项显示数量
• 主题颜色
• 字体大小
• 预览显示方式

相关设置保存在 AppearanceSettingsPane.swift 中。

存储管理

通过"存储"设置控制历史记录行为：

• 最大历史记录数量
• 历史保留时间
• 忽略特定应用的复制内容
• 排除特定类型的剪贴板数据

高级终端配置

高级用户可以通过终端命令进行更多自定义：

# 修改剪贴板检查间隔（默认0.5秒）
defaults write org.p0deje.Maccy clipboardCheckInterval 0.1

# 恢复隐藏的底部状态栏
defaults write org.p0deje.Maccy showFooter 1

常见问题解决

快捷键冲突怎么办？

1. 打开系统设置 → 键盘 → 快捷键
2. 搜索冲突的快捷键组合
3. 修改或禁用系统默认的冲突快捷键
4. 重启Maccy后重新设置

无法粘贴问题排查

如果选择项目后无法自动粘贴，请检查：

1. "偏好设置"中已启用"自动粘贴"选项
2. Maccy已添加到系统设置 → 隐私与安全性 → 辅助功能中
3. 重启Maccy后重试

忽略Universal Clipboard内容

想要忽略来自其他Apple设备的通用剪贴板内容：

1. 打开偏好设置 → 忽略 → 剪贴板类型
2. 添加 com.apple.is-remote-clipboard 类型

更多常见问题解答请参考项目FAQ部分

多语言支持：全球用户的共同选择

Maccy支持30多种语言，包括中文、英文、日文、法文等。语言文件存放在 Maccy/zh-Hans.lproj/ 等目录下，社区持续贡献新的语言翻译。

总结：效率提升的必备工具

从简单的剪贴板历史记录到高级的内容管理，Maccy以轻量、快速、安全的特性，成为macOS用户提升效率的得力助手。无论你是程序员、设计师还是普通用户，都能从中获得显著的效率提升。

现在就下载使用Maccy，让复制粘贴从此变得轻松高效！如有任何问题或建议，欢迎参与项目贡献。

项目授权协议：MIT