通义灵码在VSCode中使用教程

这页解决什么问题

装完插件之后，多数人只会用行内补全，剩下的能力从未打开过。本页按 VS Code 的实际交互路径，把灵码在编辑器里能做的事拆成五种操作方式，每种都说明"在哪里触发、输入什么、输出到哪里"。

准备：确认三件事都就绪

1. 扩展面板中灵码插件已安装且处于启用状态。
2. 侧边栏灵码面板已登录阿里云账号（未登录时所有能力都静默失效）。
3. 已用 文件 → 打开文件夹 方式打开项目目录，而不是只打开了单个游离文件。项目上下文能力依赖工作区目录结构。

用法一：行内代码补全

这是默认开启的能力。在编辑器里正常写代码，停顿时会出现灰色的续写建议。

• 接受整段建议：按 Tab。
• 放弃建议：按 Esc，或继续输入自己的代码。
• 逐词接受：多数环境下可用 Ctrl/Cmd + → 按词接受，适合建议方向对但细节要改的情况。

实用技巧：补全质量高度依赖上文。写函数前先补一行说明意图的注释，再写函数签名，建议的准确率明显高于直接开写函数体。

用法二：注释生成代码

在空行写一段自然语言注释描述需求，然后换行等待建议。例如：

# 读取 data/orders.csv，按 user_id 聚合订单金额，返回金额前 10 的用户列表

换行后灵码会尝试给出实现。这种方式适合边界清楚、输入输出明确的小函数。需求越含糊，生成结果偏离越远，所以注释里要写清数据来源、返回结构、异常处理要求。

用法三：选中代码做解释、优化、改写

1. 用鼠标或键盘选中一段代码。
2. 右键打开上下文菜单，找到灵码相关的子菜单。
3. 按需选择：解释这段代码、优化写法、添加注释、生成单元测试等操作项。
4. 结果输出到侧边栏对话面板，确认无误后再手动复制回代码，或使用面板提供的插入操作。

使用建议：读别人代码时"解释"最省时间；提交前用"优化"过一遍容易发现遗漏的边界判断。但优化结果必须自己复核，尤其涉及并发、事务、异常分支的改写。

用法四：生成单元测试

选中目标函数 → 右键选择生成单元测试。生成结果通常包含正常路径与若干边界用例。落地时注意两点：

• 生成的测试用的断言库、测试框架不一定与项目现有约定一致，需要按项目实际框架调整。
• 生成的用例可能引用了不存在的 fixture 或 mock，需要补齐依赖后才能跑通。

把它当作"用例清单起草工具"而不是"可直接合并的测试代码"，效率收益最大。

用法五：在对话面板里带项目上下文提问

侧边栏对话面板不只能聊天，关键在于让它看到正确的上下文：

• 提问时明确引用文件路径，例如"结合 src/service/order.py 说明退款流程的调用链"。
• 先在编辑器里打开或选中相关代码，再在面板提问，模型能拿到当前焦点内容。
• 大范围问题拆小：与其问"这个项目怎么改成异步"，不如逐个模块问"这个函数改成异步后调用方需要改哪些地方"。

典型使用场景

• 接手陌生代码库：用解释能力快速摸清核心模块职责，比逐行读快很多。
• 写重复性代码：DTO 转换、参数校验、样板 CRUD，注释生成代码收益最高。
• 补测试欠债：批量为老函数起草用例清单，再人工筛选保留有价值的。
• 代码评审前自检：提交前让它过一遍改动段落，找明显的空判、异常吞掉、资源未释放。
• 写不熟的语言：偶尔要改一段陌生语言的脚本时，用它把意图翻译成对应语言的惯用写法。

使用节奏建议

不要把补全当成主要生产方式。更稳的节奏是：自己先定结构与接口 → 让补全填实现细节 → 自己复核边界与异常 → 用生成测试补用例。反过来（让 AI 定结构、自己填细节）容易产出难以维护的代码。

本页信息来源

• 通义灵码官方站点与使用文档：https://lingma.aliyun.com/
• VS Code 官方扩展交互规范（补全接受、上下文菜单、输出面板等编辑器通用行为）

本页描述的是操作路径与使用方法，不提供版本号、许可证、发布日期与配置要求等易过期数据。快捷键与菜单项名称可能随插件迭代调整，实际以你本地插件面板显示为准。