Skip to main content

@Folders

在 Cursor 中使用 @Folders 引用文件夹时，根据设置不同会有两种行为模式。

文件夹引用

模式一：文件夹引用（Folder Referencing）​

默认情况下，当您使用 @ 符号引用文件夹时，AI 会获得该文件夹的路径信息，从而知晓具体查找位置。

此外，Cursor 还会向 AI 提供该文件夹内容的概览信息，帮助建立必要的上下文环境，以便 AI 更准确地决策后续操作。

模式二：完整文件夹内容（Full Folder Content）​

自 v0.50 版本起新增『完整文件夹内容』模式。

启用该模式后，当您 @ 引用文件夹时，Cursor 会尝试将文件夹内所有文件内容纳入上下文环境。这意味着 AI 无需自行读取文件即可获取完整信息。

启用方式​

要启用此功能，请在 Cursor 设置中切换 Full Folder Content 选项。

启动方式

使用方法​

在 Cursor 中使用 @Folders 引用文件夹并启用「完整文件夹内容」功能时，系统将尽可能将所选文件夹内的所有文件纳入上下文环境。相较于默认仅提供文件夹路径和概览信息的行为，这种方式能提供更全面的上下文支持。

对于超出上下文窗口容量的大型文件夹，Cursor 将执行以下操作：

  • 在上下文菜单中显示大纲视图
  • 通过工具提示展示已包含文件数量
  • 智能管理可用上下文空间

该系统使 Cursor 能够高效处理任意规模的文件夹，同时保持对 AI 可用上下文的精确掌控。无论您使用默认的文件夹引用方式，还是启用了完整文件夹内容功能（自 v0.50 版本起可用），Cursor 都能确保为您的需求提供恰如其分的上下文支持。

功能限制​

定价 / 上下文窗口​

完整文件夹内容功能对所有用户开放。

如果您启用了 Max 模式，此功能可能会显著增加请求成本。因为 Cursor 会尝试包含文件夹的全部内容，使用所选模型的完整上下文窗口。

这是由于添加到提示词中的文件越多，这些文件消耗的输入 token 就越多，从而导致请求成本上升。

忽略文件​

通过 .cursorignore 或 .gitignore 文件忽略的文件将不会被包含在上下文中。