@ 符号 ¶
Cursor 中 @ 符号的用法详解 ¶
在 Cursor 的输入框中（如 Composer、Chat 和 Cmd K），可以通过输入 @ 来调用各种功能。一个弹出菜单会显示建议列表，并根据你的输入自动筛选出最相关的建议。你可以使用上下箭头键浏览建议列表，按 Enter 键选择建议。如果选择的是一个类别（如 Files），建议列表会进一步筛选，显示该类别中最相关的项目。
以下是按指定顺序排列的所有 @ 符号及相关符号的详细用法：
-
@Files
- 功能：引用项目中的特定文件。
- 用法：输入
@Files，可以搜索并选择项目中的文件。Cursor 会显示文件路径预览，确保你选择的是正确的文件。 - 特别功能：在 Chat 中，如果文件内容过长，Cursor 会将文件分块并根据查询相关性重新排序。还可以通过拖放文件到输入框来添加上下文。
-
@Folders
- 功能：引用整个文件夹以提供更广泛的上下文。
- 用法：有两种模式。默认模式下，引用文件夹时，AI 会获得文件夹路径和内容概述。自 v0.50 起，可以启用“完整文件夹内容”模式，将文件夹内所有文件内容尽可能包含在上下文中（可在设置中启用）。对于大型文件夹，Cursor 会显示概要视图并智能管理上下文空间。
- 限制：完整文件夹内容模式可能会增加请求成本（特别是启用 Max 模式时），且被
.cursorignore或.gitignore忽略的文件不会包含在上下文中。
-
@Code
- 功能：引用代码库中的特定代码片段或符号。
- 用法：输入
@Code，可以预览代码内容以确保引用正确。还可以通过编辑器选择代码片段，然后使用快捷键（如Ctrl/⌘ Shift L添加到 Chat，或Ctrl/⌘ Shift K添加到 Cmd K）将其加入上下文。
-
@Docs
- 功能：访问文档和指南。
- 用法：Cursor 内置了第三方文档，可以通过
@Docs访问。还可以添加自定义文档，输入 URL 后 Cursor 会索引并学习该文档，定期更新以保持内容最新。自定义文档可在设置中管理（编辑、删除或添加）。
-
@Git
- 功能：访问 Git 历史和更改。
- 用法：包括
@Commit（引用当前工作状态与上次提交的差异，显示未提交的修改、添加和删除文件）和@Branch（比较当前分支与主分支的差异，显示分支中独有的提交和更改）。
-
@Web
- 功能：引用外部网络资源和文档。
- 用法：通过
@Web，Cursor 会根据查询和上下文构建搜索查询，并在网络上查找相关信息作为额外上下文。适用于获取最新信息或快速抓取多个网站内容。在 Agent 模式下，Cursor 会自动搜索网络以获取最新信息或额外上下文。
-
@Definitions
- 功能：查找符号定义（仅限 Cmd K）。
- 用法：通过
@Definitions将附近的定义添加到 Cmd K 作为上下文。
-
@Link (paste)
- 功能：创建指向特定代码或文档的链接。
- 用法：粘贴链接时，Cursor 会自动将其标记为
@Link。如果不想标记，可以点击链接并选择“取消链接”，或使用无格式粘贴（按住Shift键）。
-
@Lint Errors
- 功能：引用 lint 错误（仅限 Chat）。
- 用法：通过
@Lint Errors自动捕获并提供当前活动文件中的 lint 错误和警告作为上下文。Composer 和 Agent 默认可以看到 lint 错误。
-
@Recent Changes
- 功能：引用代码库中的最近更改。
- 用法：通过
@Recent Changes将最近的代码修改作为上下文传递。
-
@Cursor Rules
- 功能：处理 Cursor 规则。
- 用法：通过
@Cursor Rules访问项目规则和指南，明确将其应用到当前上下文。
-
@Notepads
- 功能：访问记事本。
- 用法：通过
@Notepads引用你的记事本内容作为上下文。记事本是强大的上下文共享工具，连接 Composer 和 Chat 交互，允许创建可复用的上下文。
-
@Past Chats
- 功能：处理已总结的 Composer 会话。
- 用法：通过
@Past Chats引用之前聊天的总结内容，特别适用于需要引用长期会话上下文、开始相关新任务或分享之前会话的推理和决策时。
-
# Files
- 功能：将文件添加到上下文而不引用。
- 用法：输入
#后跟文件名，专注于特定文件，结合@符号进行精确的上下文控制。
-
/ Commands
- 功能：将打开和活动的文件添加到上下文。
- 用法：输入
/快速引用当前打开的编辑器标签或活动编辑器标签（即视图中可见的标签，通常在分割布局时显示多个编辑器）。