通义灵码写代码时怎么提供上下文？

在写代码这件事上，AI 补全工具遇到的最大尴尬，莫过于“它帮你写的代码和项目实际结构对不上”“补全内容里缺了关键的依赖导入”“跨文件调用时直接提示找不到方法”。问题出在哪？往往不是模型不够聪明，而是你忘了告诉它“该看什么”。通义灵码不是靠猜的，它需要你明确指定上下文——你把“看什么”交代清楚，它才能把“写什么”整明白。

下面把这几种指定上下文的方式拆开来说，每个场景都有对应的“投喂”姿势。

用快捷键快速添加单个文件上下文

在智能问答输入框里直接输入

，回车后当前工作区的文件树就弹出来了，点选你要关联的 .ja va、.py、.ts 等源文件即可。操作很简单，点选就行。但有个小坑：在 VS Code 中，文件必须先保存，否则它不会出现在列表里——未保存的临时文件不被索引。选中后，输入框左侧会出现文件图标和路径，上下文的绑定量就一目了然了。

批量处理模块时用 #folder 添加整个目录

如果你想让 AI 理解一个完整功能模块（比如 src/order/ 下的所有 Controller、Service、DTO），只加一个文件就太不够了。这时候可以用

。三种方式任选：

• 输入框里直接输入

  #folder
  → 从弹出目录树中逐级展开 → 选中目标文件夹 → 点击确认。
• 点击输入框左侧的 “+” 图标 → 选择“目录” → 浏览并定位到目标文件夹 → 确认。
• 如果你用的是 JetBrains IDE，最快的方式是直接从 Project 面板拖拽整个文件夹到输入框中。

  【拖拽前务必确保该文件夹属于当前打开的工作区】
  ，否则会提示“无法访问外部路径”。

用截图让 AI 看懂 UI 或报错现场

遇到设计稿、控制台红字报错、浏览器渲染异常时，文字描述再精确也容易失真。这时候让 AI “亲眼看见”比什么都管用。输入

→ 选择本地 PNG/JPG 截图文件 → 发送提问。JetBrains 用户更省事：截图后直接 Ctrl+V 粘贴进输入框，系统自动识别为图片上下文。注意：VS Code 不支持粘贴截图，必须走文件选择流程；而且图片分辨率不宜过低，否则 AI 可能误读按钮文字或堆栈行号。

让 AI 知道你正在改哪几行代码

这个方式最轻量，不需要任何输入指令。第一步：在编辑器中用鼠标选中你正在修改的代码段（可以是3行，也可以是整个函数）。第二步：观察输入框左侧是否自动出现“#selection”标签——出现即表示上下文已绑定。第三步：直接输入问题，例如“这段逻辑有空指针风险，怎么加判空？”，AI 会严格基于你选中的这几行分析，不会擅自扩展到其他无关代码。但有个关键点：

。

基于 Git 变更做精准评审

你刚提交了几个文件的修改，想让 AI 帮你检查是否有遗漏的异常处理或违反规范的地方。在输入框输入

，系统会自动提取 Git 暂存区（staged）里的所有变更内容作为上下文。这相当于把 git diff 的结果直接喂给 AI，它能逐行比对新增/删除/修改部分，给出针对性建议。注意：如果还没 git add，变更还在工作区（unstaged），#codeChanges 就读不到——。

说实话，这些上下文的用法并不复杂，但很多人往往忽略了“先喂上下文”这个前置步骤，导致 AI 答非所问。记住一个原则：你给 AI 的“视野”越精准，它给你的答案就越靠谱。