@Folders

在 Chat 和 Composer 中引用文件夹作为上下文，提升 AI 对话效果。

在 Cursor 中使用 @Folders 引用文件夹时，根据你的设置有两种不同的行为：

模式一：文件夹引用（默认）

默认情况下，当你 @ 一个文件夹时，AI 会获得该文件夹的路径，从而知道应该查找的位置。

此外，Cursor 会为 AI 提供该文件夹内容的概览，帮助 AI 获取合适的上下文，以便做出正确的决策。

模式二：完整文件夹内容

从 v0.50 版本开始，你可以启用Full Folder Content完整文件夹内容功能。

启用后，当你 @ 一个文件夹时，Cursor 会尝试将该文件夹的全部内容包含到上下文中，这样 AI 无需自己再去读取文件。

如何启用

在 Cursor 设置中切换Full Folder Content选项即可启用此功能。

如何使用

启用“完整文件夹内容”后，使用 @Folders 引用文件夹时，所选文件夹中的所有文件（如可行）都会被包含进上下文。这比默认行为（仅提供路径和概览）能为 AI 提供更全面的上下文。

对于超出上下文窗口大小的大型文件夹，Cursor 会：

• 在上下文菜单中显示大纲视图
• 显示包含了多少文件的提示
• 智能管理可用的上下文空间

无论你使用默认的文件夹引用，还是启用了完整文件夹内容功能（v0.50 及以上），Cursor 都能确保为你的需求提供合适的上下文级别。

限制说明

价格 / 上下文窗口

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

如果你启用了 Max 模式，这一功能可能会显著增加请求成本，因为 Cursor 会尝试将整个文件夹内容填满模型的上下文窗口。添加的文件越多，消耗的输入 token 也越多，请求成本也会随之增加。

忽略文件

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