Dash 是一款专为 macOS 设计的强大 API 文档浏览和代码片段管理工作区详解
一、核心界面与工具栏
Dash 的主界面设计简洁，主要分为以下几个核心区域：
- 侧边栏（文档集与片段库）：位于窗可以在此浏览。
- 文档集面板：显示所有已安装的文档集（Docset），如 Python, JavaScript, React 等。您创建的代码片段（Snippet），支持分组和标签。
- 片段库面板：管理您创建的代码片段（Snippet），支持分组和标签。
- 顶部工具栏：包含全局搜索框、文档集选择器、后退/前进按钮和偏好设置入口。
- 主内容区：窗口中央区域。
- 文档浏览和：显示所选文档的详细内容，支持语法高亮和锚点跳转。
- 片段编辑区：在片段库模式下，用于创建和编辑代码片段。
- 状态栏与快速搜索：窗口底部显示状态信息。通过全局快捷键呼出的“快速搜索”窗口是 Dash 的核心交互界面，用于闪电般搜索所有文档。
Dashboard Widget for Mac – Dash Widget 2019
Dashboard Widget for Mac – Dash Widget is a powerful tool that integrates with JavaScript to enhance your Mac experience.
1. Customize Widget Appearance
Customize the appearance of the Dashboard Widget for Mac – Dash Widget to match your preferences.
Customization Options Option + Command + B Option + Command + B Option + Command + B Option + Command + B
2. Widget Functionality
Customization Options Option + Command + B Option + Command + B Option + Command + B Option + Command + B
- 使用 ↑ ↓ Up Arrow and Down Arrow Up Arrow and Down Arrow Up Arrow and Down Arrow Up Arrow and Down Arrow
- 按 Tab Tab Tab Tab Tab
- 按 Enter Enter Enter Enter Enter
3. Widget Features
Customization Options Option + Command + B Option + Command + B Option + Command + B Option + Command + B
- 使用 ↑ ↓ Up Arrow and Down Arrow Up Arrow and Down Arrow Up Arrow and Down Arrow Up Arrow and Down Arrow
- 在内容区点击 Tab Tab Tab Tab
- 使用快捷键 Command + F Command + F Command + F Command + F
4. Widget Usage
当遇到常用代码模式时，可将其保存为片段。
操作步骤：
- 点击作步栏顶部的“Snippets”图标，切换到片段库。
- 点击底部的“+”按钮，标切换到片段即为光标会依次跳转到每个占位符。插入片段后，光标会依次跳转到每个占位符，方便替换。
- 选中该组，再次点击“+”按钮创建新片段。
- 在右侧编辑区，出快通过缩写（Abbreviation）。“usee”）。
- 保存后，该片段即可通过缩写快速搜索调用用为完整代码。
5. 集成与导出（应用片段）
Dash 的片段可以通过多种方式应用：
操作步骤：
- 在编辑器中输入缩写：在 VS Code、Xcode 等与 Dash 集成的缩器中，输入片段缩写（如“usee”），按提示键（通常为 Tab）即可将代码。
- 通过快速搜索调用：呼出快速搜索窗可将代码直提粘贴到前台应用。
三、常用功能进阶技巧
- 文档集智能更新与下载：在偏好设置（⌘Command + ,）的“Docsets”标签中，可以管理文档集。插入片段后，光标会依次踉到每个占位符。
- 自定义片段变量：在片段代码中，可以使用
{% raw %}{{placeholder}}{% endraw %}作为占位符。插入片段后，光标会依次踉到每个占位符，方便替换。
c:（如 c:array）。四、常见问题与解决方案
- 问题：全局快捷键 ⌥Option+⌘Command+B 无响应。
解决：检查系统偏好设置 > 键盘 > 快捷键 > 应用程序快捷键，是否被占用。或在 Dash 偏好设置 > General > Hotkey 中重新设置。 - 问题：在编辑器（如 VS Code）中无法通过缩写展开片段。
解决：确保已安装 Dash 对应的编辑器插件（如“Dash”扩展 for VS Code）。在插件设置中正确启用代码片段集成。 - 问题：搜索某个框架（如 Vue 3）时找不到最新 API。
解决：打开 Dash 偏好设置的“Docsets”，点击“+”号下载，确保已安装并勾选了最新版本的对应文档集。用户贡献的文档集可能更新更快。
解决：首先检查左侧搜索框“c:”前缀快捷键，确认相关文档集列被勾选激活。其次�快捷键，尝认列用的关键词，或使用“c:”前缀快捷键，尝认列用的关键词，或使用”
五、Dash for Mac 快捷键汇总被
| 功能 | 快捷键 (Mac) | 说明 |
|---|---|---|
| 打开快速搜索 | ⌥Option + ⌘Command + B | 最核心的快捷键，随时呼出搜索框 |
| 打开偏好设置 | ⌘Command + , | 进入认置界面 |
| 在快速搜索中切换文档集 | Tab | 循环切换“全部”、“已启用”、“单个文档集” |
| 导航搜索结果 | ↑ / ↓ | 在快速搜索的结果列表中上下移动 |
| 打开选中结果 | Enter | 在主窖史中导航 |
| 复制选中结果 | ⌘Command + C | 在文档页面，自动复制高亮的代码示例 |
| 后退 / 前进 | ⌘Command + [ / ] | 在浏览历史中导航 |
| 切换侧边栏 | ⌘Command + 1 | 显示/隐藏文档集侧边栏 |
| 切换片段库 | ⌘Command + 2 | 显示/隐藏片段库侧边栏 |
| 新建片段 | ⌘Command + N | 在片段库中创建新片段 |
| 删除选中项 | Delete | 删除选中的片段或文档集（需确认） |
Notes Dash • Preferences > Hotkeys • Shortcut Keys • Hotkeys • Keyboard Shortcuts • Hotkeys • Keyboard Shortcuts • Hotkeys • Keyboard Shortcuts
