Raycast 使用入门

概述

Raycast 是 macOS 上的启动器和效率工具。它可以启动应用、搜索文件、做计算、管理窗口、保存剪贴板历史、展开常用文本、打开常用链接，也可以通过扩展接入 GitHub、Notion、Slack、1Password、浏览器标签页等工具。

这类工具的用法重点不在“功能全不全”，而在把高频动作收进同一个入口。先把全局唤起、命令面板、快捷键和几个内置功能配置好，Raycast 才会从“另一个搜索框”变成真正顺手的工作台。

安装启动

可以从官网下载，也可以用 Homebrew 安装：

brew install --cask raycast

安装后第一次打开 Raycast，按提示授予必要权限。常见权限包括：

• 辅助功能：窗口管理、部分自动化动作需要。
• 通讯录、日历：搜索联系人、日程时需要。
• 自动化权限：读取浏览器当前标签页、把内容发给其他应用时可能需要。

Raycast 默认全局唤起快捷键是 ⌥ + Space。如果想替代 Spotlight，可以把 Raycast 设置成 ⌘ + Space，并在系统设置里关闭 Spotlight 的同名快捷键。

路径：System Settings > Keyboard > Keyboard Shortcuts > Spotlight。

基础操作

按全局快捷键打开 Raycast 后，直接输入要找的东西：

• 应用名：例如 safari、terminal、vscode。
• 命令名：例如 Clipboard History、Create Quicklink。
• 文件名：搜索本机文件和目录。
• 表达式：例如 128 * 3.5、10ft in m。
• URL：例如 https://github.com。

选中结果后按 Enter 执行默认动作。需要更多操作时，按 ⌘ + K 打开 Action Panel。Raycast 很多功能都藏在 Action Panel 里，不用一开始就记所有命令。

快捷键

Raycast 的快捷键分两类：

• 全局热键：不打开 Raycast 也能直接执行，例如打开剪贴板历史。
• 命令内快捷键：Raycast 窗口已经打开时，在列表、表单、结果页里使用。

常用基础快捷键如下：

快捷键	作用	说明
⌥ + Space	打开 / 关闭 Raycast	默认全局快捷键，可修改
Enter	执行默认动作	打开应用、运行命令、复制结果等
⌘ + K	打开 Action Panel	查看当前结果的更多操作
Esc	返回 / 关闭	在根搜索页按下会关闭窗口
⌘ + Esc	回到根搜索	从子页面快速返回首页
⌘ + W	关闭 Raycast 窗口	不退出应用进程
⌘ + ,	打开设置	修改快捷键、扩展和功能偏好
⌘ + ⇧ + /	打开用户指南	查看官方帮助
↑ / ↓	上下移动	列表和搜索结果中使用
⌥ + ↑ / ⌥ + ↓	上一页 / 下一页	长列表里翻页
⌘ + ↑ / ⌘ + ↓	上一组 / 下一组	在分组结果间跳转
Ctrl + N / Ctrl + P	下一个 / 上一个	默认启用的 Emacs 风格导航

表单里常用这些按键：

快捷键	作用
Tab	下一个字段
⇧ + Tab	上一个字段
⌘ + Enter	提交表单
Esc	取消并返回

如果习惯 Vim 导航，可以在 Raycast Settings > Keyboard > Navigation Bindings 里启用 Vim 风格按键。

快捷设置

Raycast 的快捷方式主要有两种：

• Alias：在 Raycast 搜索框里输入的短别名，例如输入 cb 打开剪贴板历史。
• Hotkey：系统级快捷键，不需要先打开 Raycast，例如 ⌥ + ⌘ + V 直接打开剪贴板历史。

配置入口：Raycast Settings > Shortcuts。

适合设置 Alias 的功能：

功能	Alias 示例	原因
Clipboard History	cb	使用频率高，但不一定要占一个全局热键
Search Files	sf	文件搜索常用，别名比输入完整命令快
Create Quicklink	cq	创建频率中等，别名足够
Create Snippet	cs	创建频率中等，别名足够
Search Emoji & Symbols	emoji	避免和系统 emoji 快捷键冲突

适合设置 Hotkey 的功能：

功能	Hotkey 示例	说明
Clipboard History	⌥ + ⌘ + V	高频粘贴历史
Left Half	⌃ + ⌥ + ←	窗口移动到左半屏
Right Half	⌃ + ⌥ + →	窗口移动到右半屏
Maximize	⌃ + ⌥ + Enter	最大化当前窗口
Search Snippets	⌥ + ⌘ + S	快速插入长文本

Hotkey 不要设置太多。全局快捷键多了以后，记忆成本会超过收益，还容易和系统、输入法、编辑器冲突。

应用文件

Raycast 最基础的用法是启动应用和查找文件。

启动应用：

1. 打开 Raycast。
2. 输入应用名，例如 chrome。
3. 按 Enter 打开。

搜索文件：

1. 打开 Raycast。
2. 输入文件名或目录名。
3. 如果根搜索没有出现结果，输入 Search Files 使用专门的文件搜索命令。
4. 选中文件后按 Enter 打开，或按 ⌘ + K 查看复制路径、在 Finder 中显示等操作。

常用文件和目录可以加到 Favorites。选中结果后按 ⌘ + F，之后会更容易出现在搜索结果前面。

计算转换

Raycast 的 Calculator 直接集成在根搜索里，不需要先打开计算器应用。

可以输入：

128 * 3.5
52% of 900
10ft in m
5 usd in cny
1 btc in usd
5pm london in tokyo
monday in 3 weeks
days until 2026-12-31

常用快捷键：

快捷键	作用
Enter	复制结果
⌘ + Enter	复制未格式化结果
⌘ + ⇧ + Enter	复制问题和答案

货币、加密货币和时区数据会随外部数据源变化。需要精确财务结果时，Raycast 适合做快速换算，不适合作为最终结算依据。

剪贴板

Clipboard History 会保存复制过的文本、图片、文件、链接、邮件和颜色。建议给它单独配置 Hotkey，例如 ⌥ + ⌘ + V。

常用操作：

操作	快捷键	说明
打开剪贴板历史	自定义 Hotkey	推荐设置成全局快捷键
粘贴选中项	Enter	粘贴到当前输入位置
打开更多操作	⌘ + K	编辑、固定、删除、转成 snippet 等
按类型过滤	⌘ + P	文本、图片、文件、链接、颜色等
复制到剪贴板	⌘ + Enter	不直接粘贴
重命名条目	⌘ + E	方便以后搜索
固定条目	⌘ + .	常用内容保留在前面
删除条目	⌘ + X	删除当前选中项

建议在设置里排除密码管理器、银行、企业聊天等敏感应用。剪贴板历史很方便，但不该成为密钥收纳箱。

Quicklinks

Quicklinks 用来保存常用 URL、文件路径、目录路径和 deeplink。它适合处理“每天都要打开，但每次都要找”的入口。

创建方式：

1. 打开 Raycast。
2. 输入 Create Quicklink。
3. 填写链接、名称、图标和打开方式。
4. 需要时添加 Tag、Alias 或 Hotkey。

常见示例：

https://github.com
~/Projects/blog
vscode://file/Users/me/Projects/blog
slack://channel?id=xxx

Quicklinks 支持动态占位符。最常用的是 {argument}，打开时会提示输入参数。

Google 搜索示例：

https://www.google.com/search?q={argument name="query"}

GitHub 仓库示例：

https://github.com/{argument name="org"}/{argument name="repo"}

常见占位符：

占位符	作用
{argument}	打开时输入参数，最多可用 3 个
{clipboard}	使用当前剪贴板内容
{date}	当前日期
{time}	当前时间
{datetime}	当前日期和时间
{uuid}	生成 UUID
{calculator}	计算表达式结果

Quicklinks 多了以后要用 Tag 分类。按项目、系统、客户或用途分组，比只靠搜索名字更稳。

Snippets

Snippets 用来保存常用文本，并可通过关键词自动展开。适合邮件模板、地址、命令片段、代码模板、常用回复和符号组合。

创建方式：

1. 打开 Raycast。
2. 输入 Create Snippet。
3. 填写内容和名称。
4. 可选填写 Keyword，用于自动展开。
5. 可选添加 Tag。

示例：

场景	Keyword	内容示例
邮箱	;mail	name@example.com
地址	;addr	常用收件地址
命令	;glog	git log --oneline --graph --decorate --all
日期	;today	带 {date} 的动态文本

Keyword 建议带一个不常用于正常输入的前缀，例如 ; 或 //。这样可以减少误触展开。

Snippet 内容有长度限制，适合保存常用片段，不适合当长文档仓库。较长的模板可以放到笔记或代码仓库里，再用 Quicklink 打开。

窗口管理

Window Management 可以移动和缩放当前前台窗口。第一次使用时，Raycast 会要求开启辅助功能权限。

常用命令：

命令	作用	Hotkey 示例
Left Half	左半屏	⌃ + ⌥ + ←
Right Half	右半屏	⌃ + ⌥ + →
Top Half	上半屏	⌃ + ⌥ + ↑
Bottom Half	下半屏	⌃ + ⌥ + ↓
Maximize	最大化	⌃ + ⌥ + Enter
Center	居中	⌃ + ⌥ + C
Restore	恢复上次大小	⌃ + ⌥ + R
Next Display	移到下一块屏幕	⌃ + ⌥ + ⌘ + →
Previous Display	移到上一块屏幕	⌃ + ⌥ + ⌘ + ←

配置入口：Raycast Settings > Extensions > Window Management。

可以设置窗口边距，也可以把 Left Half 和 Right Half 配成循环不同宽度。多显示器用户建议先配左右半屏、最大化、移动到下一显示器这几个动作。

扩展商店

Raycast Store 里有大量第三方扩展。安装方式很直接：

1. 打开 Raycast。
2. 输入 Store。
3. 搜索扩展名称。
4. 按 Enter 安装。
5. 到设置里配置账号、权限、Alias 和 Hotkey。

常见扩展方向：

• 密码：1Password。
• 浏览器：Chrome、Arc、Safari 标签页和书签搜索。
• 项目管理：Linear、Jira、Todoist。
• 文档：Notion、Obsidian。
• 沟通：Slack、Zoom。
• 开发：GitHub、GitLab、Docker、npm、Homebrew。
• 翻译：Google Translate、DeepL。

扩展不要见一个装一个。优先装能替代高频切应用动作的扩展，例如查浏览器标签页、搜 Notion、复制 1Password 一次性验证码。

Raycast AI

Raycast AI 提供 Quick AI、AI Chat 和 AI Commands。可用功能、模型和额度取决于账号方案。

常用入口：

入口	用法
Tab	在根搜索中进入 Quick AI，适合一次性问题
AI Chat	长对话、附件、上下文较多的场景
AI Commands	把固定提示词做成命令

AI Commands 适合固定流程，例如：

• 翻译选中文本。
• 把剪贴板内容改成更正式的语气。
• 总结当前浏览器页面。
• 根据选中文本生成提交信息。

AI 功能和剪贴板、选中文本、浏览器标签页配合使用时很顺，但要注意公司代码、客户资料和隐私内容的使用边界。

备份迁移

换机器或重装系统前，可以用 Export Settings & Data 导出配置。Raycast 会生成 .rayconfig 文件，并要求设置至少 8 位的密码。

导出内容通常包括：

• 设置、Alias 和 Hotkey。
• Quicklinks。
• Snippets。
• Clipboard History。
• 已安装扩展。
• AI Chats、Commands 和 Agents。
• Window Management Layouts。

迁移到新机器后，使用 Import Settings & Data 导入。团队共享的内容建议优先用共享 Snippets、共享文档或代码仓库管理，不要只靠个人导出文件流转。

推荐流程

一个比较稳的配置顺序：

1. 把 Raycast 全局快捷键设置好，必要时替代 Spotlight。
2. 给 Clipboard History 设置 Hotkey。
3. 给 Search Files、Create Quicklink、Create Snippet 设置 Alias。
4. 给 Left Half、Right Half、Maximize 设置窗口管理 Hotkey。
5. 创建 5 到 10 个真正高频的 Quicklinks。
6. 创建常用邮箱、地址、命令、回复模板等 Snippets。
7. 安装少量高频扩展，并给核心命令加 Alias 或 Hotkey。
8. 用 Export Settings & Data 做一次备份。

Raycast 的配置不需要一次完成。每次遇到重复动作，就把它收进 Quicklink、Snippet、Alias、Hotkey 或扩展里，配置会自然长成适合自己的样子。

排错

唤不出来

检查全局快捷键是否被 Spotlight、输入法切换或 Siri 占用。路径通常在：

• System Settings > Keyboard > Keyboard Shortcuts > Spotlight
• System Settings > Keyboard > Keyboard Shortcuts > Input Sources
• System Settings > Apple Intelligence & Siri

窗口不能移动

Window Management 需要辅助功能权限。到 System Settings > Privacy & Security > Accessibility，确认 Raycast 已启用。

剪贴板没记录

检查 Clipboard History 是否启用，当前应用是否在禁用列表中。密码管理器和部分安全应用的内容被忽略是正常现象。

文件搜不到

先确认文件确实在本机可索引目录里，再尝试 Search Files 命令。外接盘、网络盘、临时目录和权限受限目录可能不会稳定出现在根搜索结果里。

快捷键冲突

到 Raycast Settings > Shortcuts 搜索对应命令。Raycast 会显示已配置的 Alias 和 Hotkey；如果某个组合键被系统或其他应用抢占，换成更少冲突的组合。

参考

• Raycast 官网
• Raycast Quickstart
• Raycast Search Bar
• Raycast Keyboard Shortcuts
• Raycast Command Aliases & Hotkeys
• Raycast Clipboard History
• Raycast Quicklinks
• Raycast Snippets
• Raycast Calculator
• Raycast Window Management
• Raycast Import & Export