人人都会AI编程

3.2.4 @ 上下文引用功能(文件/文件夹/终端/网页)

更新时间:2026-06-29

在对话中,直接 @ 引用本地文件、整个文件夹、终端输出或网页内容,可以省去复制粘贴的麻烦,让 AI 精准获取上下文,从而给出更贴切的回答。

@文件

  • 输入 @ 后,从弹出的文件列表中选择,或直接键入路径。
  • 示例:@src/utils/helper.ts
  • 效果:AI 会读取该文件全部内容,之后你可以说“给这个函数加上类型守卫”,它就能基于最新代码作答。

@文件夹

  • 使用 @folder 将整个文件夹的目录结构和关键文件摘要纳入上下文。
  • 示例:@folder components/
  • 效果:AI 能了解组件间的依赖关系,适合做跨文件重构、统一命名风格或批量修复引用路径。

@终端

  • 自动引用最近一条终端命令及其输出;也可手动指定命令。
  • 示例:@terminal (抓取上次运行的完整输出)或 @terminal npm run test(运行命令并获取输出)。
  • 效果:遇到报错时,无需截图,直接让 AI 根据终端的错误日志给出修复建议。对调试和学习命令行操作特别实用。

@网页

  • @web 引用在线页面文字内容,方便根据最新文档或参考资料提问。
  • 示例:@web https://react.dev/reference/react/useEffect
  • 效果:AI 会抓取该页面正文,接着你可以问“按这个文档,我的副作用清理函数写对了吗?” 只获取静态文本,需保持网络可用。

实用提示

  • 所有引用内容均会显示在对话中,可随时确认或移除。
  • 自动截断过长内容以保证上下文窗口不溢出。
  • 文件夹引用会遵守 .gitignore 规则,避免引入无关文件。
  • 终端引用支持直接粘贴命令让 AI 解释或改写,如“用更安全的方式改写这条命令”。