通义灵码史上最全使用教程：秀一秀AI编程新肌肉

一、概述

1.1介绍

通义灵码，是阿里云出品的一款基于通义大模型的智能编码辅助工具，提供行级/函数级实时续写、自然语言生成代码、单元测试生成、代码优化、注释生成、代码解释、研发智能问答、异常报错排查等能力，并针对阿里云的云服务使用场景调优，助力开发者高效、流畅的编码。

1.2核心场景

1.2.1代码智能生成

经过海量优秀开源代码数据训练，可根据当前代码文件及跨文件的上下文，为你生成行级/函数级代码、单元测试、代码优化建议等。沉浸式编码心流，秒级生成速度，让你更专注在技术设计，高质高效地完成编码工作。

1.2.2研发智能问答

基于海量研发文档、产品文档、通用研发知识、阿里云的云服务文档和 SDK/OpenAPI 文档等进行问答训练，为你答疑解惑，助你轻松解决研发问题。

1.3产品优势

• 跨文件感知让代码生成更贴合业务场景： 客户端和模型层同步优化针对代码跨文件上下文感知能力，生成代码更加贴合当前代码库的业务场景。
• 阿里云服务使用场景友好： 专门针对阿里云的云服务使用、SDK/OpenAPI 的使用等场景调优，编码时能够更加便捷地使用阿里云服务；在对阿里云使用有疑问时，智能编码助手的回答也将更加有效。
• 适配多 IDE 的原生设计，符合开发者使用习惯： 适配 IDE 原生主题、交互模式，让开发者感受到 IDE 原生的视觉和交互体验，更符合开发者使用习惯。
• 研发问答、文档/代码搜索能力，打造沉浸式编码： 无需切换工具，IDE 客户端内即可满足开发者编码场景中的技术资料检索、技术难题解答的诉求，打造开发者沉浸式编码体验。
• 双模引擎，自由切换： 支持极速本地模型、云端大模型两种代码补全模型，支持一键切换，满足不同网络环境、不同补全强度的场景诉求。

二、下载和安装指南

官网安装地址：

通义灵码安装教程-阿里云

通义灵码支持 Visual Studio Code、JetBrains IDEs，及远程开发场景（Remote SSH、Docker、WSL、Web IDE），安装后登录阿里云账号即可开始使用。

2.1Visual Studio Code

本安装步骤适用于 macOS、Windows 或 Linux 的 Visual Studio Code 中安装和使用通义灵码。

2.1.1步骤一：准备工作

• 通义灵码需要登录阿里云后方可使用，如果你尚未拥有一个阿里云账号，可前往注册阿里云账号；
• 操作系统：Windows 7 及以上、macOS、Linux；
• 下载并安装** **Visual Studio Code 1.70.x 及以上版本。

2.1.2步骤二：在 Visual Studio Code 安装通义灵码

方法 1：从插件市场安装

说明

单击立即安装，唤起 Visual Studio Code 插件市场直接安装，安装后请重启 IDE，即可开启智能编码之旅。

1. 打开 Visual Studio Code 扩展窗口，搜索 TONGYI Lingma，找到通义灵码后单击安装。
2. 安装完成后，请重启 Visual Studio Code。

方法 2：下载安装包安装

1. 单击下方链接，下载 Visual Studio Code 的 VSIX 安装包；⇩ TONGYI Lingma-VS Code
2. 下载完安装包后，打开 Visual Studio Code 后，单击扩展，单击更多按钮，在下拉菜单中单击 从 VSIX 安装，选择下载的 VSIX 文件后安装；

1. 安装完成后，请重启 Visual Studio Code。

2.1.3步骤三：登录阿里云账号开启智能编码之旅

1. 重启 Visual Studio Code 后，单击侧边导航的通义灵码，在通义灵码助手的窗口单击登录按钮。

Tips：如果安装后在侧边导航上找不到通义灵码入口，可鼠标聚焦在侧边导航后右键查看，勾选通义灵码后即可插件入口配置在侧边导航上。

1. 单击登录后，将前往阿里云官网登录，完成阿里云登录后，即可前往 IDE 客户端开始使用。

Tips：WebIDE、Remote SSH、WSL等可以使用阿里云 AK/SK 登录通义灵码，可查看使用 AK/SK 登录通义灵码。

2.2JetBrains IDEs

本安装步骤适用于 macOS、Windows 或 Linux 的 JetBrains IDEs 中安装和使用通义灵码。

2.2.1步骤一：准备工作

• 通义灵码需要登录阿里云后方可使用，如果你尚未拥有一个阿里云账号，可前往注册阿里云账号；
• 操作系统：Windows 7 及以上、macOS、Linux；
• 下载并安装兼容的 JetBrains IDEs 2020.3 及以上版本，通义灵码与以下 IDE 兼容：

• IntelliJ IDEA（旗舰版、社区版、教育版）
• Android Studio
• CLion
• GoLand
• PhpStorm
• PyCharm（专业版、社区版、教育版）
• Rider
• RubyMine
• RustRover
• WebStorm
• …

更多详细信息，请参阅JetBrains IDE工具查找器。

2.2.2步骤二：在 JetBrains IDEs 安装通义灵码

Tips：以在 IntelliJ IDEA 中安装通义灵码为例。

说明

鉴于很多开发者感兴趣我使用的 IDEA 的主题，我也分享一下信息：

我使用的 IDEA 的主题是 JetBrains IDEs 的 New UI，需要将 IDEA 升级到最新版哦，打开设置后，在 Appearance & Behavior 中即可看到 New UI 的配置入口。

方法 1：从插件市场安装

1. 打开 IntelliJ IDEA 设置窗口，在插件市场中搜索 TONGYI Lingma，找到通义灵码后单击安装。
2. 安装完成后，请重启 IntelliJ IDEA。

方法 2：下载安装包安装

1. 单击下方链接，下载 JetBrains IDEs 的 zip 安装包；⇩ TONGYI Lingma - JetBrains
2. 下载完安装包后，打开 IntelliJ IDEA 后，打开设置，在插件管理的设置下拉菜单中单击从本地安装插件，选择下载的 zip 文件后安装。

1. 安装完成后，请重启 IntelliJ IDEA。

2.2.3步骤三：登录阿里云账号开启智能编码之旅

1. 重启 IntelliJ IDEA 后，单击侧边导航的通义灵码，在通义灵码助手的窗口单击登录按钮。

1. 单击登录后，将前往阿里云官网登录，完成阿里云登录后，即可前往 IDE 客户端开始使用。

Tips：Remote SSH、WSL 等可以使用阿里云 AK/SK 登录通义灵码，可查看使用 AK/SK 登录通义灵码。

三、功能介绍

3.1行级/函数级实时续写

根据当前语法和跨文件的代码上下文，实时生成行、函数建议代码。

3.1.1自然语言生成代码

通过自然语言描述你想要的功能，可直接在编辑器区生成代码，编码心流不间断。

3.1.2单元测试生成

支持根据 JUnit、Mockito、Spring Test、unit test、pytest 等框架生成单元测试。

3.1.3代码优化

深度分析代码及其上下文，迅速识别潜在的编码问题，从简单的语法错误到复杂的性能瓶颈，均能够指出问题所在，并提供具体的优化建议代码。

3.1.4代码注释生成

一键生成方法注释及行间注释，节省你写代码注释的时间，并能够有效提升代码可读性。

3.1.5代码解释

覆盖各种编程语言，选中代码后可自动识别编程语言并生成代码解释。跨越语言的边界，让你阅读代码更高效。

3.1.6研发领域自由问答

遇到编码疑问、技术难题时，一键唤起通义灵码，无需离开 IDE 客户端，即可快速获得答案和解决思路。聚焦研发领域知识的问答，帮助开发者快速解决问题。

3.1.7异常报错智能排查（Java）

当运行出现异常报错时，一键启动报错排查的智能答疑，可结合运行代码、异常堆栈等报错上下文，快速给出排查思路或修复建议代码。

3.1.8双模引擎，一键切换

支持极速离线模型（Java/Python）、云端大模型两种代码补全方式，极速离线模型拥有单行补全的能力，云端大模型具备函数生成的能力。在你需要的时候，可一键切换，满足不同网络环境、不同补全强度的场景诉求。

四、使用指南

4.1概述

通义灵码，作为智能编码助手，可以在你进行编码工作时，为你提供行级/函数级实时续写、自然语言生成代码、单元测试生成、代码优化、注释生成、代码解释、研发智能问答、异常报错排查等辅助编码工作的功能。

4.2代码智能生成

4.2.1行级/函数级实时续写

当你在 IDE 编辑器区进行代码编写时，在开启自动云端生成的模式下，通义灵码会根据当前代码文件及相关代码文件的上下文，自动为你生成行级/函数级的代码建议，此时你可以使用快捷键采纳、废弃、查看不同的代码建议。

同时，当你在编码的过程中，也可以通过快捷键 ⌥ P 手动触发生成代码建议，具体如下：

Tips：不同操作系统的快捷键配置可查看配置指南。

4.2.2自然语言生成代码

通义灵码支持两种通过自然语言描述生成代码的方式：

1. 在编辑器中，直接通过注释的方式描述你需要的功能，直接在编辑器中生成代码建议，单击 Tab 可直接采纳 ；
2. 在智能问答中，直接描述你需要的功能，智能问答助手将为你生成代码建议，并支持一键插入或复制代码。

4.3生成单元测试、代码优化建议**、代码注释、代码解释**

4.3.1选中代码后，一键触发功能

当你选中的代码后，支持生成单元测试、代码优化、代码注释或代码解释，有 3 种触发方式：

1. 在编辑器中，单击右键找到通义灵码功能操作入口，单击对应功能操作；
2. 在智能问答中，直接单击对应功能操作；
3. 在智能问答中，使用 / 查看快捷指令，单击对应功能操作。

4.3.2生成回答后，一键采纳和追问

单击对应功能操作后，在智能问答区中，通义灵码为你所选代码生成相关回答，此时你可以根据诉求进行操作，不同功能的对应操作如下：

• 生成单元测试：

• 采纳单元测试代码建议：支持一键插入、复制、或者新建代码文件，可快速采纳生成的单元测试代码建议；
• 更换单元测试框架：目前提供基于 JUnit、Mockito、Spring Test、unit test、pytest 等框架生成单元测试代码建议，在回答完成后，可以根据需要切换框架重新生成；
• 新建文件：支持一键保存单元测试代码为新文件，方便进行查看和修改。

• 生成代码优化建议

• 采纳代码优化建议：针对优化建议中的建议代码，支持一键插入、复制，快速采纳生成的建议代码；
• 查看 Diff：单击查看 Diff 按钮，将快速唤起 IDE Diff 查看窗口，快速了解建议和源代码的变更；

• 生成代码注释：

• **采纳代码注释建议：支持一键插入、复制，**可快速采纳生成的代码注释建议；
• **查看 Diff：**单击查看 Diff 按钮，将快速唤起 IDE Diff 查看窗口，快速了解建议和源代码的变更。

• 解释代码：

• 支持重试、更详细、更简单、中文/英文解释的追问。

4.3.3函数的行间快捷入口

当需要针对一个方法或功能实现生成单元测试、代码注释、代码解释时，无需选中代码，可直接单击函数上方的快捷入口触发相关功能操作。

Tips：目前该功能 Visual Studio Code 上支持语言：Java、Python、Go、JS/TS、C/C++，JetBrains IDEs 支持语言：Java、Python。

4.4研发智能问答

使用通义灵码的智能问答时，为了通义灵码与你的对话能够更友好、高效，希望你能够在输入问题时：

• 选中代码，开始输入你的问题，通义灵码将围绕着选中代码与你开展对话；
• 精准表达问题，以及给出相对详细的上下文输入， 比如选中的代码、日志、报错信息等；
• 多多互动，告诉通义灵码，所给出代码建议或回答是否满足你的预期，或生成内容存在的具体瑕疵，通义灵码也会不断改进。

4.4.1开始自由问答

当你编码遇到问题，缺乏具体解决思路时，可单击 IDE 侧边工具导航或使用⌘ ⇧ L唤起通义灵码智能问答助手，无需离开 IDE 客户端，即可快速获得答案和解决思路。

4.4.2多种快捷指令问答

在智能问答输入框中，预置了多个常用快捷指令，输入 / 即可看到相关快捷指令：

• **/help：**学习如何使用通义灵码；
• **/explain code：**解释选中的代码；
• **/generate unit test：**为选中的代码生成单元测试；
• **/generate comment：**为选中的代码生成方法注释或行间注释；
• **/generate optimization：**为选中的代码生成优化建议和相关优化代码；
• **/clear context：**当你在会话中时，单击后将清空上下文记忆；

4.4.3新建会话

在智能问答窗口中，单击右上角的新建按钮即可新建会话窗口，单击后会话窗口将会到默认状态。

4.4.4查看会话历史

历史会话功能帮助你检索和回顾与通义灵码的交流记录，方便针对多次的建议进行对比和选择。不管你在哪个 IDE 客户端上、哪个工程中，均可以查看或搜索你和通义灵码的历史会话。

4.4.5异常报错排查（IntelliJ IDEA）

当运行出现异常报错时，在运行标准输出窗口中，即可看到通义灵码的快捷操作按钮，单击后，通义灵码将结合运行代码、异常堆栈等报错上下文，快速给出排查思路或修复建议。

4.5IntelliJ IDEA 中技术文档和代码片段搜索

在 IntelliJ IDEA 客户端内，如果你在编码过程中有需要进行技术资料检索、代码片段搜索的诉求，无须离开 IDE，单击侧边导航的通义灵码，单击搜索，即可开始搜索。

五、参考链接

1. 通义灵码产品介绍_智能编码助手_AI编程_云效(Apsara Devops)-阿里云帮助中心
2. 通义灵码下载和安装手册_智能编码助手_AI编程_云效(Apsara Devops)-阿里云帮助中心
3. 通义灵码使用指南_智能编码助手_AI编程_云效(Apsara Devops)-阿里云帮助中心