Cursor中@符号上下文注入失效时，需按引用目标选择对应指令：一、@Files引用单文件；二、@Folders引用整个目录；三、@Code引用选中代码片段；四、@Docs引用外部文档；五、@Codebase执行全库语义搜索。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Cursor 中使用 @ 符号但无法精准注入上下文，可能是由于未正确匹配引用类型或未触发上下文过滤机制。以下是针对不同引用目标的具体操作方式：
一、引用单个文件（@Files）
@Files 指令用于将指定文件的全部内容作为上下文提供给 AI，使 AI 能基于该文件的原始结构、变量定义与逻辑流程生成响应。该方式适用于修改配置、修复函数或解释报错位置等场景。
1、在 Chat 输入框、⌘K 命令面板或终端中输入 @Files 并按下空格或 Enter。
2、方向键 ↓ 浏览文件列表，或直接输入文件名关键词（如 vite.config.ts）快速筛选。
3、光标定位到目标文件后按 Enter，文件内容即被加载为上下文。
4、输入指令，例如：请将此文件中的 rollupOptions.external 改为动态导入形式。
二、引用整个目录（@Folders）
@Folders 指令会递归扫描所选目录下所有文件，并构建模块级语义理解，帮助 AI 把握组件间依赖、命名规范与架构风格。该方式适用于重构模块、生成新组件或审查模块一致性。
1、在输入框中键入 @Folders 后触发弹出菜单。
2、使用方向键导航至目标文件夹（如 src/components），按 Enter 确认。
3、AI 将自动索引该路径下全部 .ts、.tsx、.js 等可读文件（受 .cursorignore 排除规则限制）。
4、发出请求，例如：为该组件目录新增一个支持暗色模式的 Button 组件，保持现有 props 接口一致。
三、引用代码片段（@Code）
@Code 是最细粒度的上下文注入方式，仅将当前编辑器中手动选中的代码块纳入分析范围，避免无关内容干扰推理。该方式适用于跨文件逻辑调试、算法优化或局部重写。
1、在编辑器中用鼠标或键盘（Shift+↑/↓）精确选中一段或多段不连续代码。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
2、在 Chat 或 ⌘K 中输入 @Code，系统自动识别并高亮已选内容。
3、若需补充说明，可在同一行追加自然语言指令，例如：@Code 请将这段 Promise 链改为 async/await 并添加错误重试逻辑。
4、确认发送后，AI 仅依据所选代码的语法结构与运行时行为生成结果。
四、引用外部文档（@Docs）
@Docs 指令允许 AI 实时检索并解析指定技术栈的官方文档内容，确保生成逻辑符合最新 API 规范与最佳实践。该方式适用于使用新特性、验证参数合法性或查阅弃用警告。
1、在输入框中输入 @Docs 后紧跟技术名称（如 react、zod 或完整 URL）。
2、Cursor 自动匹配对应文档源（如 React 官网、Zod GitHub Wiki 或 @https://example.com/api）并加载关键章节。
3、输入问题，例如：@Docs zod 请根据 Zod v3.22 的 safeParseAsync 文档，改写此校验逻辑。
4、AI 将结合文档中函数签名、返回类型与示例代码生成适配代码。
五、执行全库语义搜索（@Codebase）
@Codebase 指令不加载全部文件，而是对项目代码库建立索引并执行相关性排序，快速定位核心类、高频调用函数或潜在重复逻辑。该方式适用于理解陌生项目、查找功能入口点或识别技术债。
1、在 Chat 或 ⌘K 中输入 @Codebase 并按空格。
2、输入自然语言描述目标（如 用户登录流程涉及的所有服务层文件 或 处理 JWT 的工具函数）。
3、AI 返回按相关性排序的文件列表及匹配代码行摘要（非全文）。
4、点击任一结果可自动跳转至对应位置，也可追加指令：请对比这两个文件中 decodeToken 的实现差异。
