Raycast 代码片段：开发者文本扩展指南（2026）

您每天要输入多少次相同的邮件回复、相同的 console.log 模式、相同的 git 提交前缀或相同的 Slack 站会模板？如果答案超过两次，您就需要文本扩展。而如果您已经在使用 Raycast，这个功能已经内置——无需额外应用，无需额外订阅。

Raycast Snippets 让您创建关键词触发的文本快捷方式，在输入时自动展开。输入 ;;email，它立刻变成您的完整邮件地址；输入 ;;pr，它变成预填了今日日期的 Pull Request 模板。本指南涵盖一切：创建片段、动态占位符、真实开发者示例，以及从 TextExpander 等工具迁移。如果您刚认识 Raycast，可先阅读我们的Raycast 完整入门指南。

什么是 Raycast Snippets？

Snippets 是 Raycast 内置的文本扩展快捷方式。每个片段由两部分组成：

1. 关键词触发器 — 您输入的短字符串（例如 ;;email、;;sig、;;log）
2. 展开文本 — 触发关键词后替换为的完整内容

当您在任意应用中输入关键词时，Raycast 会检测到并立即用展开文本替换。这适用于所有地方——代码编辑器、邮件客户端、Slack、终端、浏览器以及任何其他文本输入框。

;; 前缀是约定俗成的默认方式，但您可以配置任意前缀。关键是使用一个您通常不会输入的前缀，这样片段不会意外触发。

创建您的第一个代码片段

创建片段大约只需 10 秒：

1. 打开 Raycast（Cmd+Space）
2. 输入"创建代码片段"并按回车
3. 输入一个名称（例如"邮件地址"）
4. 设置关键词（例如 ;;email）
5. 输入片段内容（例如 alex@example.com）
6. 保存

现在在 Mac 任意位置输入 ;;email，它立即展开。没有确认对话框，没有延迟——文字直接出现。

您也可以在 Raycast 中输入"搜索代码片段"来浏览和管理所有片段。

动态占位符

静态文本扩展已经很有用，但动态占位符才是让片段真正强大的地方。Raycast 支持多种占位符类型，在展开时插入上下文感知内容。

日期与时间

以任意格式插入当前日期或时间：

• {date} — 按系统区域设置显示当前日期
• {date:YYYY-MM-DD} — 自定义日期格式（例如 2026-03-10）
• {date:MMMM D, YYYY} — 长格式（例如 March 10, 2026）
• {time} — 当前时间
• {time:HH:mm} — 24 小时格式

这对日志、日记、会议记录以及任何包含当前日期的模板极为有用。

剪贴板内容

{clipboard} 占位符插入当前剪贴板中的内容。这让您可以围绕粘贴的内容构建模板。例如，创建 Markdown 链接的片段：

[{clipboard}](url)

复制一个 URL，输入片段关键词，URL 会自动插入 Markdown 链接模板中。

光标位置

{cursor} 占位符设置片段展开后光标的位置。对于需要填写特定字段的模板来说至关重要：

console.log('{cursor}', );

展开后，光标位于引号之间，等待您输入标签。

随机 UUID

{uuid} 占位符生成随机 UUID，适用于测试数据、唯一标识符或开发过程中的占位 ID。

开发者片段示例

以下是我最常使用的片段，欢迎取用并根据您的工作流程调整。

代码样板

• ;;log → console.log('{cursor}', ); — 带标签的快速调试日志
• ;;imp → import { {cursor} } from ''; — ES 模块导入
• ;;raf → 带导出的 React 箭头函数组件模板
• ;;ust → const [{cursor}, set] = useState(); — React useState Hook
• ;;uef → useEffect(() => { {cursor} }, []); — React useEffect Hook
• ;;try → 带错误日志的 try/catch 块
• ;;af → const {cursor} = async () => { }; — 异步箭头函数

Git 与 PR 模板

• ;;commit → 约定式提交模板：feat({cursor}):
• ;;pr → 包含"变更内容"、"原因"、"测试方法"和"截图"章节的完整 PR 描述模板
• ;;fixcommit → fix({cursor}):
• ;;wip → WIP: {cursor} [skip ci]

邮件与沟通

• ;;email → 您的邮件地址
• ;;sig → 完整邮件签名块
• ;;thanks → 感谢您的快速回复！{cursor}
• ;;lgtm → LGTM！可以合并。{cursor} 做得很好。
• ;;ooo → 带返回日期占位符的外出自动回复模板

日常工作流

• ;;standup → 站会模板：## 站会 {date:YYYY-MM-DD}\n**昨日：**\n- {cursor}\n**今日：**\n- \n**阻塞：**\n- 无
• ;;meeting → 包含日期、参与者、议程和行动项章节的会议记录模板
• ;;todo → - [ ] {cursor} — Markdown 待办事项
• ;;now → {date:YYYY-MM-DD} {time:HH:mm} — 当前时间戳

文档与 Markdown

• ;;link → [{cursor}]({clipboard}) — 使用剪贴板 URL 的 Markdown 链接
• ;;img → ![{cursor}]({clipboard}) — 使用剪贴板 URL 的 Markdown 图片
• ;;table → 带标题的 Markdown 表格框架
• ;;code → 带语言占位符的代码块
• ;;details → HTML <details><summary> 可折叠章节

片段集合与分组

随着片段库的增长，组织变得尤为重要。Raycast 允许您将片段整理到分组（也称为集合）中。您可以创建如下分组：

• 代码 — 所有编程相关片段
• 沟通 — 邮件模板、Slack 回复、PR 评论
• 个人 — 地址、电话、证件号码
• 工作 — 公司专用模板、项目名称、API 端点
• Markdown — 文档格式化快捷方式

分组纯粹用于组织，不影响片段的工作方式。但当您有 50 个以上的片段时，在"搜索代码片段"视图中按类别浏览会大大简化管理。

从 TextExpander 和 Alfred 导入

如果您已在使用 TextExpander、Alfred 或其他文本扩展工具，无需从头重建。Raycast 支持从其他工具导入片段。

从 TextExpander 导入

1. 在 TextExpander 中，将片段导出为 CSV 文件
2. 在 Raycast 中，进入 Snippets 设置并使用导入选项
3. 将 CSV 列映射到 Raycast 字段（关键词、内容、名称）
4. 审查后保存

从 Alfred 导入

1. 导出您的 Alfred 片段集合
2. Raycast 在大多数情况下可直接导入 Alfred 片段格式
3. 逐个检查兼容性——嵌套片段等高级 Alfred 功能可能需要手动调整

大多数简单文本扩展片段可以干净迁移。带有脚本或复杂逻辑的片段可能需要重新创建为 Raycast Script Commands。更多功能对比，请参阅我们的最佳 Raycast 扩展指南，了解扩展与片段如何相辅相成。

Raycast Snippets vs TextExpander vs Alfred Snippets

结论：对大多数开发者而言，Raycast Snippets 覆盖了 90% 的文本扩展需求，且完全免费。TextExpander 的高级功能（填写表单、嵌套片段、JavaScript 宏）更强大，但需要月费订阅。Alfred 的 Powerpack 包含片段功能，但 Raycast 的片段体验更为精致。如果您想深入了解 Raycast 作为完整的TextExpander 替代品，我们有专门的指南涵盖高级文本扩展工作流。

如果您目前在使用 TextExpander 且已使用 Raycast，可以尝试迁移片段并取消订阅。大多数用户发现自己并不需要那些高级功能。

与团队共享片段

如果您使用 Raycast Teams 计划，可以创建自动同步给所有团队成员的共享片段库。这对以下场景很有价值：

• 代码风格一致性 — 共享样板片段确保所有人使用相同的模式
• 客户支持模板 — 常见问题的标准化回复
• 文档规范 — README、ADR 和更新日志的共享 Markdown 模板
• 新员工入职 — 新成员无需手动配置即可获得所有团队片段

即使没有 Teams 计划，您也可以通过导出片段并让团队成员导入的方式手动共享。这不是自动的，但对小团队来说足够用。

片段高手进阶技巧

使用片段一段时间后，以下高级技巧会让您更快：

• 使用一致的前缀 — 按类型组织前缀：;;c- 代表代码，;;e- 代表邮件，;;m- 代表 Markdown
• 关键词保持简短 — 速度才是重点。;;log 胜过 ;;consolelog
• 善用搜索 — 忘记关键词？打开 Raycast，输入"搜索代码片段"，在完整库中浏览搜索
• 结合剪贴板使用 — 先复制相关内容，再触发使用 {clipboard} 的片段构建上下文感知文本
• 构建片段链 — 用一个片段创建模板，再用另一个片段填充其中的部分内容
• 学习日期格式代码 — 掌握格式代码（YYYY、MM、DD、HH、mm），以项目所需的精确格式创建时间戳
• 每季度审查和精简 — 删除不再使用的片段，保持库的精简和快速搜索

开始使用

如果您已安装 Raycast，一切就绪。Snippets 是免费版的核心功能——无需安装扩展，无需升级。打开 Raycast，输入"创建代码片段"，建立您的第一个片段。

如果您还未安装 Raycast，请参阅我们的分步设置指南，五分钟内即可开始创建片段。

要在多台 Mac 间同步片段并获得包含 AI 的完整 Pro 功能，请查看当前最优惠的 Raycast Pro 方案——8 折优惠外加 14 天免费试用，无需优惠码。

常见问题解答

Raycast Snippets 是免费的吗？

是的。Raycast Snippets 在免费版即可使用，对可创建的片段数量没有限制。动态占位符、关键词触发和自动展开均在免费版支持。Raycast Pro 添加云同步功能，让您的片段在多台 Mac 间同步，Teams 计划支持共享片段库。

Raycast Snippets 支持动态内容吗？

支持。Raycast Snippets 支持动态占位符，包括当前日期和时间（多种格式）、剪贴板内容、展开后的光标位置以及随机 UUID。例如，您可以创建一个以 YYYY-MM-DD 格式插入今日日期的片段，或将当前剪贴板内容粘贴到模板中。

我可以从 TextExpander 或 Alfred 导入片段吗？

可以。Raycast 支持从其他工具导入片段。您可以将 TextExpander 片段导出为 CSV 后导入 Raycast。Alfred 片段集也可以迁移，但高级功能（如嵌套片段或复杂脚本）可能需要手动调整。

我可以与团队共享片段吗？

与团队成员共享片段需要 Raycast Teams 计划。Teams 计划可创建共享片段库，自动同步给所有团队成员，适用于统一代码规范、邮件模板和文档约定。所有计划均支持通过导出/导入方式进行单独分享。