通义灵码写代码时如何提供上下文？

通义灵码需明确指定上下文才能准确理解代码：用#file添加单文件、#folder添加目录、#image上传截图、#selection绑定选中代码、#codeChanges读取Git暂存区变更。

你在写代码时遇到“AI生成的代码和项目实际结构对不上”“补全内容缺少关键依赖导入”“跨文件调用提示找不到方法”这类问题，根本原因往往是通义灵码没看到你真正需要参考的代码上下文——它不是靠猜，而是靠你明确告诉它“看什么”。

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

在智能问答输入框里直接输入 #file，回车后会弹出当前工作区的文件树，点选你要关联的 .java/.py/.ts 等源文件即可。

这一步操作起来很简单，直接点选就行；但注意：VS Code 中必须先保存该文件，否则它不会出现在列表里——未保存的临时文件不被索引。

选中后，输入框左侧会出现文件图标和路径，说明上下文已生效。

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

当你需要让 AI 理解一个完整功能模块（比如 src/order/ 下所有 Controller、Service、DTO），就不能只加单个文件了。

方法一：在输入框输入 #folder → 从弹出目录树中逐级展开 → 选中目标文件夹 → 点击确认。

方法二：点击输入框左侧的 “+” 图标 → 选择“目录” → 浏览并定位到目标文件夹 → 确认。

方法三（仅 JetBrains IDE）：直接从 Project 面板拖拽整个文件夹到输入框中——这是最快的方式，【拖拽前务必确保该文件夹属于当前打开的工作区】，否则会提示“无法访问外部路径”。

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

当你面对设计稿、控制台红字报错、浏览器渲染异常时，文字描述往往失真，这时就得让 AI “亲眼看见”。

在输入框输入 #image → 选择本地 PNG/JPG 截图文件 → 发送提问。

JetBrains 用户更省事：截图后直接 Ctrl+V 粘贴进输入框，系统自动识别为图片上下文。

注意：VS Code 不支持粘贴截图，必须走文件选择流程；且图片分辨率不宜过低，否则 AI 可能误读按钮文字或堆栈行号。

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

第一步：在编辑器中用鼠标选中你正在修改的代码段（可以是3行，也可以是整个函数）。

第二步：观察输入框左侧是否自动出现“#selection”标签——出现即表示上下文已绑定。

第三步：直接输入问题，例如“这段逻辑有空指针风险，怎么加判空？”，AI 会严格基于你选中的这几行分析，不会擅自扩展到其他无关代码。

这个方式最轻量，不需要任何输入指令，但【选中后必须立刻提问，否则切换焦点会导致上下文自动清除】。

基于 Git 变更做精准评审

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

在输入框输入 #codeChanges，系统会自动提取 Git 暂存区（staged）里的所有变更内容作为上下文。

这相当于把 git diff 的结果直接喂给 AI，它能逐行比对新增/删除/修改部分，给出针对性建议。

注意：如果还没 git add，变更还在工作区（unstaged），#codeChanges 就读不到——【必须先执行 git add】。