在聊天框输入 @ 后选择「文件夹」，即可将整个目录作为上下文绑定给 AI。这相当于告诉 AI："别只看单个文件，这个模块下的东西你整体了解一下。"
基本用法
在 Cursor、Windsurf 或支持 @ 引用的 AI 编辑器中，输入 @ → 选择 Folder → 勾选目标目录（如 src/services 或 docs/api）。AI 会读取该目录下的文件列表、关键代码片段和层级结构，随后基于整个目录的范围回答你。
适用场景
- 批量重构：选中
utils/文件夹，让 AI 把所有工具函数从 CommonJS 统一改成 ES Module。 - 跨文件找依赖：把
components/丢进去，问 AI "哪些页面引用了 Table 组件但没传 pagination 属性"。 - 保持风格一致：基于
models/已有的 4 个模型文件，让 AI 生成第 5 个模型时遵循同样的字段命名规范。 - 写说明文档：把
src/api丢进去，让 AI 根据代码直接输出接口文档。
注意事项
- 别贪大。整个项目根目录塞进去很容易撞 Token 上限，AI 反而会"失忆"。优先圈定具体的子目录（如
src/pages/login而非整个src）。 - 配合
@文件精准打击。如果目录里有个核心文件特别重要，可以同时@文件夹+@那个关键文件，让 AI 重点阅读。 - 注意垃圾文件。确保目录里没有未忽略的
node_modules、构建产物或日志，否则 AI 可能把时间浪费在无意义的代码上。
真实示例
用户：
@frontend/src/components帮我把这些组件里的console.log全删掉，换成统一的logger.debug，别忘了 import 上面的 logger 实例。
AI：好，我扫了 components 目录下的 8 个文件，发现其中 3 个有 console.log，这是修改后的 diff...
一句话总结：@文件夹 是处理"跨文件、批量化"任务的利器，但记得缩小范围、精准投喂，别把整个项目都丢进去。