Snippetty 是一款专为 macOS 设计的轻量级、高效的代码片段管理工具。它允许开发者将常用的代码块、文本模板、命令等保存为可快速检索和插入的片段，极大地提升了编码、写作和重复性文本输入的工作效率。其核心设计理念是“快速调用，即用即走”，通过全局快捷键和简洁的界面，实现无干扰的片段管理。
一、核心界面与工作区详解
Snippetty 的界面设计以功能性和简洁性为主导，主要分为三个核心区域。
1. 菜单栏图标与主面板
启动后，Snippetty 会在屏幕顶部菜单栏显示一个图标（通常是一个“{ }”符号或类似图标）。这是与软件交互的主要入口。
- 点击菜单栏图标：会下拉显示一个搜索面板，这是Snippetty的“心脏”。面板顶部是搜索框，下方是片段列表。
- 搜索框：输入关键词可以实时过滤片段。支持通过片段标题、标签、内容进行模糊搜索。
- 片段列表：显示所有匹配搜索条件的片段。每个条目通常显示片段标题和所属分组。
2. 偏好设置窗口
通过点击菜单栏图标下拉菜单中的“Preferences…”或使用快捷键 ⌘Command + , 打开。此窗口是管理所有片段和配置软件行为的地方，包含以下几个关键标签页：
- Snippets（片段）：核心管理界面。左侧是分组列表，右侧是当前分组下的片段列表。可以在此进行创建、编辑、删除分组和片段，以及为片段设置快捷键、标签等。
- General（通用）：设置全局呼出快捷键（默认是 ⌥Option + ⌘Command + S）、启动选项、更新检查等。
- Variables（变量）：定义可在片段中使用的动态变量，如当前日期、时间、剪贴板内容等。
- Advanced（高级）：配置片段插入行为、格式化选项等。
3. 片段编辑器
在偏好设置的“Snippets”标签页中，双击任意片段或点击“+”号创建新片段时，会弹出片段编辑器窗口。此窗口包含：
- Title（标题）：片段的名称，用于搜索和识别。
- Content（内容）：片段的主体文本或代码，支持多行编辑。
- Tab Trigger（Tab触发词）：设置一个缩写，输入后按Tab键即可展开为完整片段。
- Keyboard Shortcut（键盘快捷键）：为片段分配一个全局快捷键，直接插入。
- Tags（标签）：为片段添加标签，便于分类筛选。
- Language/Syntax（语言/语法）：（如果支持）为代码片段指定语法高亮。
二、完整工作流程：从创建到使用
步骤1：创建新片段
- 点击菜单栏图标，选择 “Preferences…” 或按 ⌘Command + ,。
- 在打开的窗口中选择 “Snippets” 标签页。
- 在左侧分组列表中选择一个现有分组，或点击左下角的 “+” 创建新分组（如“Python”、“React”、“常用回复”）。
- 点击右侧片段列表下方的 “+” 按钮，创建一个新片段。
- 在弹出的编辑器中填写：
- Title: “Python HTTP GET 请求”
- Content: 输入或粘贴你的代码，例如使用 requests 库的模板代码。
- Tab Trigger: 可设置为 “pget”。
- Tags: 输入 “python, http, web”。
- 点击 “Save” 保存。
步骤2：快速搜索与插入片段
- 在任何可以输入文本的应用中（如编辑器、邮件客户端），将光标定位到需要插入的位置。
- 按下 Snippetty 的 全局呼出快捷键（默认 ⌥Option + ⌘Command + S），调出搜索面板。
- 在搜索框中输入关键词，如 “http” 或 “pget”。搜索结果会实时筛选。
- 使用 ↑ ↓ 箭头键在列表中导航，按 ↩Return 键，或直接用鼠标双击目标片段。
- 片段内容会立即插入到当前光标位置。
步骤3：使用Tab Trigger快速展开
- 在编辑器中，直接输入你为片段设置的 Tab Trigger，例如 “pget”。
- 紧接着按下 Tab 键。
- “pget” 这个词会自动被替换成完整的“Python HTTP GET 请求”代码片段。
步骤4：使用全局快捷键插入
如果你为片段设置了独立的键盘快捷键（如 ^Control + ⌥Option + G），只需在任意输入位置按下该组合键，对应的片段内容便会直接插入，无需打开搜索面板。
三、常用功能进阶技巧
1. 使用动态变量
在片段内容中，可以插入特殊变量，使其在插入时自动替换为动态值。这是Snippetty最强大的功能之一。
- 在片段编辑器的“Content”区域，输入变量占位符，例如：
今天的日期是：{{date}}。 - 常用内置变量：
{{date}}: 当前日期 (YYYY-MM-DD){{time}}: 当前时间 (HH:MM){{clipboard}}: 剪贴板中的内容{{cursor}}: 插入片段后，光标将停留在此位置。
- 你可以在“Preferences” -> “Variables”中查看和自定义变量格式。
2. 利用分组进行精细化管理
为不同类型的片段创建逻辑分组（如按编程语言、项目、工作流分类），并在搜索时结合分组名进行筛选，可以极大提升检索效率。例如，在搜索框输入 “js:fetch” 来快速定位JavaScript分组下的fetch相关片段。
3. 多光标与变量配合
在片段中设置多个 {{cursor}} 或使用类似 {{input:label}} 的变量（如果支持），可以在插入后通过按 Tab 键在多个预定义位置之间跳转，快速填充不同部分，非常适合函数模板、HTML标签等。
四、常见问题与解决方案
Q1: 全局呼出快捷键没有反应？
A1: 首先检查Snippetty是否正在运行（菜单栏是否有图标）。然后进入“Preferences” -> “General”，查看“Global Hotkey”的设置，确保其未被其他软件占用，并尝试修改为另一个组合键。
Q2: Tab Trigger 在某些应用（如终端）中不工作？
A2: 某些应用（如iTerm2、Terminal）可能拦截或使用了Tab键的默认功能。Snippetty的Tab Trigger依赖于系统的辅助功能API，在某些安全权限较高的应用中可能受限。解决方案是尝试为该应用开启辅助功能权限（系统设置-隐私与安全性-辅助功能），或改用全局快捷键/搜索面板方式插入片段。
Q3: 如何备份和迁移我的片段库？
A3: Snippetty的片段数据通常以.plist或.json格式存储在 ~/Library/Application Support/Snippetty/ 或 ~/Library/Preferences/ 目录下。定期备份整个Snippetty应用支持文件夹即可。在新机器上安装后，用备份文件覆盖对应目录即可完成迁移。
Q4: 插入的片段格式（如缩进）混乱？
A4: 检查“Preferences” -> “Advanced”中的“Paste Behavior”或“Formatting”选项。可以尝试选择“Match destination style”或调整缩进设置。确保片段内容本身的缩进符合目标编辑器的习惯。
五、Snippetty for Mac 快捷键汇总表
| 功能描述 | 快捷键 (Mac) | 使用场景 |
|---|---|---|
| 呼出/隐藏搜索面板 | ⌥Option + ⌘Command + S (默认，可自定义) | 在任何应用中快速搜索和插入片段 |
| 打开偏好设置 | ⌘Command + , | 管理片段和软件设置 |
| 在搜索面板中导航 | ↑ ↓ 箭头键 | 上下移动选择片段 |
| 插入选中片段 | ↩Return 键 | 在搜索面板中确认插入 |
| 取消并关闭搜索面板 | ⎋Esc 键 | 放弃当前操作 |
| 清空搜索框 | ⌘Command + Delete | 快速开始新的搜索 |
| 展开Tab Trigger | 输入触发词后按 Tab 键 | 在编辑器中快速展开缩写 |
| （在编辑器中）使用片段专属快捷键 | 自定义，如 ^Control+⌥Option+G | 无需搜索，一键插入特定片段 |
