在侧边栏对话时,如果问题涉及某个具体文件的内容,直接口头描述往往不够精确。使用 @文件 引用,可将该文件的完整代码作为上下文注入对话,让 AI 的回答建立在准确的源码基础上。
操作方式
在对话输入框中输入 @ 符号,在弹出的上下文类型菜单中选择「文件」,随后键入文件名关键词或直接点选目标文件。支持一次引用单个或多个文件。被引用的文件会在输入框中显示为蓝色标签,点击可移除。
适用场景
- 解释陌生逻辑:引用刚接手的复杂工具类,提问"这个函数的异常分支分别在什么条件下触发"。
- 定向修改优化:引用现有接口实现文件,要求"给这个函数加上参数校验和空值保护"。
- 生成配套代码:引用 Vue 组件文件,让 AI 基于其 Props 和 Events 生成对应的单元测试。
- 跨文件对比分析:同时
@两个文件,询问"这两个 Service 层的代码重复度如何,能否提取公共方法"。
实用提示
- 先保存再引用:AI 读取的是文件在磁盘上的最新保存版本,未保存的修改不会纳入上下文。提问前养成
Ctrl + S的习惯。 - 快速筛选:当项目文件较多时,输入
@文件后直接键入文件名的拼音首字母或关键词(如输入userctrl定位到UserController.java),无需展开目录树翻找。 - 大文件注意:若引用的文件体积过大(如数千行的自动生成代码或历史遗留单体文件),可能会占用过多上下文窗口。此时可先框选编辑器中的关键片段,再使用"选中代码定向问答"(参见 3.2.2),或明确告诉 AI"只关注第 120–150 行的
processData方法"。 - 多文件引用顺序:同时引用多个文件时,建议将你最关注的主文件放在最后提及,通常越靠后的上下文权重越高。