Cursor 的 AI 并非默认知道你在做什么。如果不给它明确的上下文，它往往只能基于当前可见的寥寥数行代码或通用知识作答，容易给出"看起来对、跑起来错"的建议。@ 指令就是用来精确告诉 AI"请看这里"的上下文锚点。
@文件
在侧边栏对话或行内编辑（Ctrl/Cmd + K）的输入框中，输入 @ 后接文件名，Cursor 会列出匹配文件，回车选中即可将该文件内容注入当前上下文。
实用场景：让 AI 根据 userModel.ts 的字段定义去修改 userController.ts；对比 config.dev.js 和 config.prod.js 的差异。
注意：如果文件超过模型上下文窗口（如几千行的大文件），Cursor 会自动截取关键部分，必要时你可手动复制核心片段贴进对话作为补充。
@代码库（@Codebase）
输入 @Codebase，Cursor 会先对整个项目做轻量级索引，随后基于代码库全局上下文回答。
实用场景：询问"项目的路由拦截逻辑写在哪里？"、"这个工具函数在哪些地方被调用了？"。
注意：首次使用或项目结构大幅变更后，索引可能需要几十秒重建；若项目极大，建议配合 @文件 缩小范围，避免上下文稀释导致回答泛泛。
@终端
输入 @Terminal，Cursor 会直接读取当前集成终端中的最新输出（如报错堆栈、构建日志、测试失败摘要）。
实用场景：运行 npm run build 后报错一大串，无需手动复制粘贴，直接 @Terminal 问"这个报错怎么修？"。
注意：如果终端输出过长（如超过数千行），建议先 clear 清屏再复现一次最小化错误，确保 AI 看到的是干净、相关的日志。
@文档与规则
输入 @Docs 或粘贴外部链接，可以引入官方 API 文档、设计稿说明等外部资料，让 AI 基于最新文档而非训练数据的旧知识作答。此外，你也可以在项目根目录放置 .cursorrules 文件写入团队规范，随后在对话中 @.cursorrules 让 AI 遵循这些约定生成代码。
实用场景：基于 React 19 Beta 文档生成新特性代码；让 AI 按照团队的 Python 类型注解规范重构函数。
通过组合使用 @ 指令，你能把 AI 从"盲人摸象"变成"看过图纸"的协作者，这是获得高质量回答最关键的一步。