Cursor @ 符号

在 Cursor 中，@ 符号是一个强大的工具，用于快速访问和引用各种上下文信息，帮助用户更高效地与 AI 交互。

在任何 AI 交互场景（如 ⌘K 命令面板、聊天窗口或终端）中输入 @，会触发上下文关联菜单，自动过滤并推荐当前项目中最相关的资源（如文件、代码片段、文档等）。

  • 键盘操作：使用 ↑/↓ 方向键导航，Enter 确认选择。若选择的是类别（如 @Files），列表会进一步过滤该类别下的具体资源。

  • 文件读取策略：对文件引用可按 Ctrl/⌘ M 切换"完整读取"或"摘要读取"模式（例如全文引用或仅关键部分）。

@ 符号

@ 符号支持以下主要指令:

功能描述使用场景
@Files引用整个文件作为上下文。支持文件路径预览和分块处理。需要引用特定文件内容时，如代码文件、文档等。
@Folders引用整个文件夹作为上下文。需要提供大量文件作为上下文，例如项目目录。
@Code引用特定代码片段作为上下文。需要针对特定代码片段进行查询或操作。
@Codebase从代码库中搜索重要文件或代码块，并根据相关性重新排序。需要在整个代码库中查找相关代码或文件。
@Git扫描 Git 提交、差异或拉取请求，帮助查找问题。需要分析 Git 相关信息，如提交记录、代码差异等。
@Web搜索网络信息作为附加上下文。需要获取最新网络信息或外部资源。
@Docs引用预设的第三方文档或自定义文档。支持添加自定义文档。需要引用外部文档或自定义知识库。
@Definitions引用附近的所有定义作为上下文。需要引用当前代码中的变量、函数等定义。
@Chat将当前聊天消息添加为上下文。在聊天中需要引用之前的对话内容。

高级使用技巧

组合指令: 输入 @Files src/utils/helper.js @Codebase，可同时引用指定文件并关联代码库全局上下文，生成高度定制化的代码。

动态资源集成: 粘贴以 @ 开头的链接（如 @https://api.example.com/docs），Cursor 会自动解析内容并纳入上下文。

隐私与配置管理: 通过 .cursorignore 文件（类似 .gitignore）排除敏感文件或目录的索引。 在 Settings > Features > Docs 中添加自定义文档链接，增强 @Docs 的覆盖范围。

典型应用场景示例

1、代码生成

  • 指令：生成用户登录功能 @Files src/models/user.js @Docs https://jwt.io/introduction
  • 结果：基于现有用户模型和 JWT 官方文档生成安全的鉴权逻辑。

2、错误排查

  • 指令：解释此报错原因 @Code 12-25 行 @Git HEAD~1
  • 结果：结合代码段和最近提交历史分析潜在问题。

3、跨文件重构

  • 指令：将类组件改为函数式组件 @Folders src/components @Codebase
  • 结果：批量转换并确保全局样式和状态管理兼容。